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1  INTRODUCTION:  PLAN  VIEW  DISPLAY  (PVD) 
CSCI  DESCRIPTION 


1.1  BACKGROUND 

The  Plan  View  Display  (PVD)  provides  the  real-time  viewing  of  an  exercise  or  the  playback 
and  review  of  an  exercise  at  a  later  time  after  recording  by  the  Data  Logger.  The  PVD  is 
used  by  a  variety  of  SIMNET  personnel,  and  provides  a  view  of  the  battlefield  as  seen 
from  directly  above— sometimes  referred  to  as  a  "bird's  eye  view."  The  PVD  is  also  used 
to  control  the  stealth  vehicle. 

The  PVD  contains  a  color-coded  display  showing  various  geographic  details,  such  as 
roads,  rivers,  and  terrain  relief.  Individual  vehicles  are  represent^  on  the  PVD  by  icons 
that  indicate  the  position  and  orientation  of  the  hull  and  the  relative  orientation  of  Ae  turreL 
The  user  can  vary  the  size  of  the  icons  by  selecting  a  magnification  level.  Shading  of  the 
geographic  display  is  performed  according  to  an  dgorithm  which  assumes  a  sun  elevation 
of  45  degrees  from  the  horizon  and  a  sun  shining  from  the  top  right-hand  comer  of  the 
display. 

A  shot  is  indicated  by  a  line  segment  emanating  from  the  firing  vehicle.  The  user  can  select 
particular  vehicles  and  obtain  detailed  information  about  them,  such  as  vehicle  location, 
speed,  alignment,  identification  number,  and  repair  and  supply  status. 

The  user  can  zoom  in  or  out  on  any  selected  area  of  the  battlefield,  pan  the  display  in  any 
direction,  obtain  intervisibility  readings,  and  optionally  overlay  grid  and/or  contour  lines  at 
selected  intervals.  Any  terrain  cross-section  is  viewable  by  selecting  its  two  endpoints. 
Numeric  values  for  the  terrain  elevation  and  corresponding  map  coordinates  (UT^  or  XY) 
for  any  point  in  the  field  of  view  are  similarly  obtainable. 

Intervisibility  is  based  on  the  idea  of  running  a  ray  from  an  eye  to  a  target  and  checking 
whether  the  ray  encounters  any  obstacles.  Levels  of  visibility  are:  target  fully  visible; 
target  partially  visible;  and,  target  invisible.  These  levels  are  color-coded  for  display. 


1.2  EXTERNAL  INTERFACES 

PVD  external  interfaces  are  illustrated  in  Figure  1.2-1,  "PVD  External  Interfaces,"  and 
summarized  in  Table  1.2-1,  "Summary  of  PVD  External  Interfaces."  PVD  receives  vehicle 
data  from  vehicle  appearance  network  packets,  exercise  playback  data  from  the  Data 
Logger,  and  Stealth  data  from  the  Stealth  vehicle.  Each  of  the  external  interfaces  above 
uses  basic  network  services.  PVD  interfaces  with  SIM  hosts  using  SIMNET  simulation 
and  data  collection  protocols;  with  the  Stealth,  using  Stealth  protocol;  and,  with  the  Data 
Logger,  using  Logger  protocol.  PVD  protocols  include  message  structures  called  'Protocol 
Data  Units'  (PDUs).  PDUs  used  by  PVD  interfaces  are  summarized  in  Table  1.2-2, 
"Summary  of  PVD  Protocol  Data  Units  (PDUs)." 
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Figure  1.2-1;  PVD  External  Interfaces. 

Table  1.2-1  summarizes  PVD  external  interfaces. 


Table  1.2-1:  Summary  of  PVD  External  Interfaces. 


Interface  ID 

From 

To 

Description 

Protocol 

PVD_EXT_IF.l 

SIM  host 

PVD 

Vehicle  Appearance, 
Exercise  Events,  etc. 

Simulation  & 

Data  Collection 

PVD_EXT_IF.2 

PVD 

SIM  host 

Vehicle  and  Exercise 
Selections,  Event 
Waypoints,  etc. 

Simulation  & 

Data  Collection 

PVD_EXT_IF.3 

Logger 

PVD 

Connect  Response 

Logger 

PVD_EXT_IF.3 

Logger 

PVD 

Playback  Vehicle 
Appearance,  Exercise 
Events,  etc. 

Logger 

PVD_EXT_IF.4 

PVD 

Logger 

Connect  Request 

Logger 

PVD_EXT_IF.4 

PVD 

Logger 

Playback  Controls 

Logger 

PVD_EXT_IF.5 

Stealth 

PVD 

Stealth  Appearance 

Stealth 

PVD_EXT_IF.6 

PVD 

Stealth 

Stealth  Input 

Stealth 
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The  PVD  Protocol  Data  Units  which  support  the  external  interfaces  are  summarized  in 
Table  1.2-2. 

Table  1.2>2:  Summary  of  PVD  Protocol  Data  Units  (PDUs). 


POU 

CSCI  From 

CSCI  To 

Synchron¬ 

ization 

Protocol 

Comments 

Stealth  Error 

Stealth 

PVD 

a  response  to 
any  cmd  from 
the  PVD 

Stealth 

0  if  command 
successful, 
positive  integer; 
error  number  if  the 
command  failed 

Stealth 

Visibility 

PVD 

Stealth 

none 

Stealth 

Allows  the  Stealth 
to  be  dynamically 
sent  to  any  (or  all) 
exercise  ID's 
contained  in  the 
PDU 

Teleport 

PVD 

Stealth 

none 

Stealth 

The  TeleportPDU 
is  sent  to  the 

Stealth  vehicle  by 
the  PVD  to  cause 
it  to  move  to  a  new 
location  and/or 
assume  a  new 
orientation; 
contains  location 
and  azimuth 

Attach 

PVD 

Stealth 

none 

Stealth 

Command  Issued 
by  the  PVD 
causing  the 

Stealth  to  attach 
to  a  particular 
vehicle; 

contains  vehiclelD 
to  which  the 

Stealth  should 
become  attached 

Attached 

Stealth 

PVD 

Sent  by  the 
Stealth 
whenever  it 
becomes 
attached  to  a 
new  vehicle 
Also  sent  by 
the  Stealth 
vehicle 
whenever  it 
ceases  to  be 
attached  to  a 
vehicle,  for 
whatever 
reason 

Stealth 

Allows  the  PVD  to 
show  the  stealth's 
current 
attachment; 

In  the  detached 
case,  the 
'detached'  field  is 
set  to  1 

(Table  1.2-2  is  continued  on  the  following  page.) 
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Table  1.2-2  (continued) 


POU 

CSCI  From 

CSCI  To 

Synchron¬ 

ization 

Protocol 

Comments 

Mimic 

PVD 

Stealth 

none 

Stealth 

Command  from 
the  PVD  to  the 
Stealth  to  show 
the  "Out  the 
window  view"  from 
a  particular 
viewport  in  a 
particlar  simulator; 
contains  vehiclelD 
that  Stealth  is  to 
mimic  and  CIG 
channel  of 
mimic'ed  vehicle 
to  display 

Meta¬ 

morphose 

PVD 

Stealth 

none 

Stealth 

Assume  the 
dynamics  of 
another  vehicle; 
contains  * 

Assume  the 
dynamics  of 
another  vehicle; 
Contains  thirteen 
vehicle  Dynamics 
values: 

FlyingCarpet  1 
Jeep  2 

Ml  3 

M2  4 

RWA  5 

FWA  6 

FreeFly  7 

Hug  8 

Tether  9 

Orbit  10 

Compass  11 
MimicLowMag  12 
MimicHiMaq  13 

Vehicle 

Appearance 

Stealth 

PVD 

periodic 

Stealth 

See  Simulation 
Protocol  in 
"SIMNET  Network 
and  Protocols." 

Other  protocols  used  by  PVD  are:  Simulation,  Data  Collection,  and  Lx)gger.  Simulation 
and  Data  Collection  PDUs  are  described  in  "SIMNET  Network  and  Protocols,  BBN, 
Report  No.  1702.”  Logger  PDUs  are  described  in  the  Data  Logger  document,  "Data 
Logger  CSCI." 


BBN  Systems  and  Technologies 


Plan  View  Display  CSCI 


1.3  INTERNAL  STRUCTURE 

The  Plan  View  Display  screen  is  divided  into  6  sections.  The  most  significant  section  is  the 
map  which  provides  a  color-coded,  two-dimensional  view  of  the  battlefield.  The  map 
combines  terrain  and  icon  displays.  Three  sections  are  located  to  the  right  of  the  map  and 
two  sections  are  located  at  the  bottom  of  the  map. 

The  sections  to  the  right  of  the  map  are  named  Information,  Events,  and  Menu.  Detailed 
information  about  a  selected  vehicle,  prompts  resulting  from  menu  choices,  and  user  error 
messages  are  displayed  in  the  Information  Section.  The  Events  Section  lists  exercise 
events  (collisions,  ground  or  vehicle  impacts,  and  indirect  fire  bursts).  The  On-Screen 
Menu  Section  can  contain  the  Connect  Menu,  Top  Menu  1,  Top  Menu  2,  or  the  Overlays 
Menu. 

The  leftmost  section  at  the  bottom  of  the  PVD  screen  provides  optional  displays  of  map 
color  keys  (terrain,  intervisibility,  or  icon)  or  a  help  message.  TTie  rightmost  section 
displays  the  coordinates  of  a  selected  location,  the  current  icon  size  and  the  zoom  ratio. 

By  default,  the  PVD  displays  vehicles  with  an  exercise  ID  of  1 .  This  ID  number  causes  all 
vehicles  on  the  network  to  be  displayed.  A  set  exercise  command  on  the  PVD  can  be 
issued  to  display  vehicles  with  another  exercise  ID  number. 

PVD  functionality  may  be  broken  down  into  these  top-level  CSCs.  Further  decomposition 
of  top-level  CSCs  into  lower-level  CSCs  and  CSUs  is  described  in  Section  2. 


•  Menu  Handling 

•  Icons 

•  Map  Handling 

•  PVD-Level  Processing 

•  Utilities 

•  Network  Processing 

•  Graphic  Support 

•  Overlays 

•  Popup  Windows 

•  Tools 

•  Remote  Device  Interfaces 

Their  interfaces  are  illustrated  in  Figure  1.3-1,  "PVD  Internal  Interfaces,"  and  summarized 
in  Table  1.3-1,  "Summary  of  PVD  Internal  Interfaces.” 
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PVD  INT  IF.3 


Menu 

PVD  INT  IF.1  Handling 


PVD  INT  IF.2 


nans: 

Icons 

Map  Handling 
Overlays 
Popup  Windows 
Tools 
Utilities 


PVD  INT  IF.6 


Network 

Processing 


Remote  Device 
Interface 


Ethernet 


Figure  1.3-1:  PVD  Internal  Interfaces. 
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Table  1 .3- 1  summarizes  PVD  Internal  Interfaces. 


Table  1.3-1: 


PVD  Internal  Interfaces. 


Interface  ID 

From 

To 

Description 

Protocol 

PVD_INT_IF.l 

Menu  H. 

Other  CSCs 

Menu  Selections 

Calls 

PVD_INT_IF.2 

Menu  H. 

Remote  Dev. 
Interfaces 

Logger  Request  Connect 

Calla 

PVD_1NT_IF.3 

Remote  Dev. 
Interfaces 

Menu  H. 

Logger  Connect  Reply 

Return 

PVD_INT_IF.4 

CSUs 

Network 

Process. 

Vehicle  and  Exercise 

IDs,  Events  Waypoints 

Shared  Memory 

PVD_INT_IF.5 

Network 

Process. 

CSUs 

Vehicle/Stealth 
Appearance,  Exercise 
Events,  etc. 

Shared  Memory 

PVD_INT_IF.6 

Remote  Dev. 
Interfaces 

CSUs 

Playback  Vehicle 
Appearance,  Exercise 
Events 

Shared  Memory 

PVD_INT_IF.6 

Remote  Dev. 
Interfaces 

CSUs 

Stealth  Menu  Selections 

Shared  Memory 

For  detailed  information  on  vehicle  and  exercise  event  message  contents  and  structures, 
refer  to  "SIMNET  Network  and  Protocols",  chapters  7  and  8. 


1.4  CONFIGURATION  AND  CONFIGURATION  MANAGEMENT 

PVD  is  written  in  the  "C"  programming  language.  It  uses  a  small  number  of  UNIX  system 
calls,  consistent  with  AT&T  UNIX  System  V. 

It  is  currently  implemented  on  Concurrent  5600  and  6600  series  machines.  Briefly,  the 
minimum  hardware  required  to  support  the  PVD  software  is: 

•  5600  Concurrent  host 

•  4  MBy  main  memory 

•  318  MBy  hard  disk 

•  12  plane  Concurrent  Graphics  system 

•  Communications  Machinery  Corporation  ethemet  card 

The  PVD  currently  runs  under  Concurrent  Real  Time  Unix  (RTU)  version  4.0A.  In  most 
cases  it  will  oi  ly  require  a  recompile  to  operate  with  other  versions  of  RTU.  The  PVD  also 
requires  appropriately  customized  versions  of  the  following  auxiliary  files: 

/simnet/bin/pvd_init.dat 

/simnet/bin/enp.bin 

/simnet/data/network.def 
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1.5  TERMINOLOGY  AND  DOCUMENTATION 

i 

• 

1.5.1  Terms  and  Abbreviations 

bit  map 

pattern  of  bit  settings  which  determine  a  visual  display.  Each  "on"  bit  turns 
on  a  picture-element  (pixel). 

bitblt 

bit  block  transfer. 

client 

a  user's  application  program. 

CSC 

Computer  Software  Component.  A  distinct  part  of  a  computer  software 
configuration  item  (CSCI).  CSCs  may  be  further  decomposed  into  other 

CSCs  and  Computer  Software  Units  (CSUs). 

CSCI 

Computer  Software  Configuration  Item.  A  configuration  item  for  computer 
software. 

csu 

Computer  Software  Unit.  An  element  of  a  Computer  Software  Component 
(CSC)  that  is  separately  testable. 

fb 

frame  buffer  (graphics  programming). 

host/Host 

mainframe 

IF 

Interface 

PDU 

Protocol  Data  Unit. 

plane 

in  graphics  programming,  'plane'  refers  to  a  block  of  raster  memory  for 
storing  a  bit  map.  One  memory  plane  allows  two  bit-settings  per  pixel-  on 
or  off.  Multiple  planes  provide  multiple  bit  settings  per  pixel;  multiple 
planes  are  used  to  achieve  hue,  layering,  or  depth  effects. 

Protocol 

a  set  of  procedures  and  data  formats  that  govern  data  communications. 

PVD 

PlanView  Display. 

resource 

in  windows  programming,  a  resource  is  a  complex  shareable  set  of  data 
structures  that  defines  a  window  object. 

• 

segment 

in  graphics  programming,  'segment'  refers  to  set  of  related  graphics 
commands. 

server 

A  program  that  controls  the  graphics  system.  A  server  acts  as  an 
intermediary  between  a  client  and  system  resources. 

shell 

a  UNIX  command  interpreter. 

SIM  host 

simulator  host  (vehicle  or  Management  Command  and  Control). 

Subscription 

Membership  of  a  simulation  entity  in  a  multicast  group;  subscribing  and 
unsubscribing  are  SIMNET  network  services  provided  by  the  association 
protocol  of  SIMNET 

Toolkit 

contains  sets  of  X-Window  options,  each  set  controlling  an  aspect  of 
windows,  for  example,  a  window’s  geometry. 

UI 

User  Interface 

UTM 

Universal  terrain  meridian 

Widgets 

X-Window  "objects"  such  as,  menus,  scrollbars,  and  buttons. 

• 
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1.5.2  References 

The  following  documents  are  relevant  to  an  understanding  of  the  PVD  and  its 
implementation  in  "C": 

•  The  "C"  Programming  Language.  Kemighan  and  Ritchie,  Prentice-Hall,  1978. 

•  DOD-STD-2167A  &  Associated  DIDs  and  DOD-STD-2168  &  Associated  DID. 
David  Maibor  Associates.  Needham  Heights,  MA,  February  29, 1988. 

•  Graphics  Application  Programming  Manual,  Massachusetts  Computer 
Corporation,  1988. 

•  Introducing  UNIX  SYSTEM  V.  Rachel  Morgan  and  Henry  McGilton,  New 
York,  McGraw-Hill,  1987 

•  "SIMNET  Data  Collection  and  Review,"  BBN  STC,  October  1988. 

•  The  SIMNET  Maintenance  Manual,  version  6.2,  March  1990. 

•  "SIMNET  Network  and  Protocols,"  BBN  Report  No.  1702. 

•  "SIMNET  Stealth  Vehicle  Functional  Specification  and  Operator’s  Manual,"  BBN 
Report  No.  7348. 
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2  PVD  CSC  DESCRIPTIONS 

In  this  section,  top-level  CSCs  are  further  decomposed  into  lower-level  CSCs  and  CSUs. 
Each  CSU  is  generally  mapped  to  a  source  file  or  library.  The  contents  of  each  CSU  is 
summarized. 

Some  top-level  CSCs  are  broken  down  into  lower-level  CSCs.  At  the  end  of  each  top-level 
CSC  description,  a  breakdown  into  lower-level  CSCs,  if  any,  is  shown,  and  each  lower- 
level  CSC  functionally  summarized.  If  there  are  no  lower-level  CSCs  corresponding  to  the 
top-level  CSC,  it  is  decomposed  into  one  or  more  CSUs.  If  there  are  lower-level  CSUs, 
each  of  these,  in  turn,  is  decomposed  into  one  or  more  CSUs. 

Interfacing  Constraints: 

PVD  interfaces  are  designed  to  be  as  modular  as  possible.  This  constrains  the 
representation  of  PVD  interfaces  as  follows: 

1)  Design  elements  at  the  same  level  of  hierarchy  are  represented  as  interfacing 
direcdy  only  with  their  design  peers;  that  is,  a  top-level  CSC  is  represented  as 
interfacing  directly  only  with  other  top-level  CSCs,  a  lower-level  CSC  is 
represent^  as  interfacing  directly  with  other  lower-level  CSCs,  and  a  CSU,  as 
interfacing  directly  only  with  other  CSUs. 

2)  Design  peers  subordinated  under  different  parent  nodes  are  represented  as 
interfacing  with  one  another  only  through  their  parent  nodes.  For  example,  a 
CSU  does  not  interface  direcdy  with  a  CSU  belonging  to  a  different  CSC; 
instead,  the  CSUs  interface  through  their  parent  CSCs. 

CSU  function  calls  represents  an  exception  to  the  second  constraint.  One  function  may  call 
any  other  function  within  its  scope  of  linkage. 

Breakdown  of  the  PVD  CSCI  is  illustrated  in  Figure  2-1. 
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Figure  2-1:  PVD  CSCI  Structure. 

This  section  provides  a  functional  summary  decomposition  for  each  of  the  CSCs  listed 
above. 

About  CSU  Descriptions: 

A  PVD  CSU  has  been  mapped  to  a  source  file  (*.c,  *.h,  or  *.a).  A  full  CSU  description 
includes  the  following  items  where  they  apply: 

Section  number  Filename 

[brief  summary  of  what  Hie  does] 

Global  Variables 

External  Static  Variables 

Function  number  Function 

Parameters 

Returns 

Error  Messages 
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Calls 

[list  of  functions  called— generally  does  not  include  standard  'C  functions  or  UNIX 
system  calls] 

Function  number  Function 
Search  Paths 

Unless  explicitly  provided,  the  search  path  for  a  source  file  iS"/simnet4>vd.  Unless 
explicitly  provided,  the  search  path  for  a  library  (filename.a)  is— /simnet/lib. 
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2.1  MENU  HANDLING  CSC  DESCRIPTION 

This  CSC  controls  all  PVD  menu  displays.  It  provides  display  and  input  handling  of 
selected  menu  commands  and  options,  error  replies,  further  prompts,  and  navigates  among 
the  various  menu  displays.  This  CSC  also  processes  and  dispatches  menu  selections  to 
other  CSCs  for  further  processing.  Figure  2.1-1  illustrates  the  decomposition  of  this  CSC. 


Figure  2.1-1:  Menu  Handling  CSC  Structure. 
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2.1.1  Initial  Menu  Handling  CSC  Description 
This  CSC  is  the  main  entry  for  menu  handling. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.1. 1-1. 


Initial 

Menu 

Handling 

3.1.1 


menu.c 

3.1.1.1 


Figure  2.1.1*1:  Menu  Handling»Initial  Menu  Handling  CSC  Structure. 

2. 1.1.1  menu.c  CSU  Description  (/simnet/pvd/lib/pvdiface.a) 

This  CSU  dispatches  a  command  choice  from  a  menu.  This  file  interprets  the  user's 
gestures  with  the  mouse  and  invokes  the  appropriate  actions. 
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Table  2.1.1.1-1:  Function  Summary  -  init_menu_params() 

This  function  initializes  the  parameters  which  describe  the  menu,  for  example,  menu  width. 

Table  2.1.1.1-2:  Function  Summary  •  init_menus() 


Function 


init  menu  oarams 


init  menu 


set  menu  window  to 


init  event  flaq  strinos 


init  database  strinos 


display  nios  menu 


display  stealth  menu 


display  catc  menu 


display  activate  menu 


init  activate  strinos 


Calls 


Where  Described 


this  file 


Concurrent  oraphics  library  subroutine 


Pvd  windows.c 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


activate.c 


Table  2.1.1.1-3:  Function  Summary  •  init_menu(  menu_tabie,  menu,  type  ) 


Parameter 


menu  table 


menu 


e 


Function 


set  entry  locations 


Parameters 


e 


MENU  ENTRY 


inter  to  register  MENU 


int 


Where  Tvoedef  Declared 


menu.h 


menu.h 


standard 


Calls 


Where  Described 


this  file 
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Table  2.1.1.1-5:  Function  Summary  -  draw_menu(  menu  ) 


Parameter 


menu 


Parameters 


inter  to  reqister  MENU 


Where  Tvoedef  Declared 


menu.h 


Function 


iv 


In 


f 


imode 


iclearoln 


maihue 


1 115 

jiuaui 

III!!!* 

I  Cl? 


make  title 


draw  disabled  backond 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


this  file 


this  file 


Table  2.1.1.1-6:  Function  Summary  •  draw_disabled_backgnd(  grp,  row  ) 


Parameters 


Parameter 


Where  Typedef  Declared 


menu.h 


standard 


Calls  1 

Function 

Where  Described 

maihue 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 


Table  2.1.1. 1-7:  Function  Summary  -  make_title(  rowjoc,  title  ) 
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Table  2.1.1. 1-8:  Function  Summary  -  init_menu_window() 


1  Calls  1 

Function 

Where  Described 

maidefw 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

Table  2.1. 1.1-9:  Function  Summary  -  menu_select(  row,  column,  x,  y  ) 


1  Parameters  1 

Parameter 

Tvne 

Where  Tvpedef  Declared 

row 

pointer  to  int 

standard 

column 

pointer  to  int 

standard 

vy _ 

pointer  to  int 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

0 

int 

menu  item  not  selected 

1 

int 

menu  item  selected 

Table  2.1.1.1-10: 

Function  Summary  -  handie_menu(  x,  y  ) 

1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

X 

int 

standard 

1 _ 

int 

standard 

17 


BBN  Systems  and  Technologies 


Plan  View  Display  CSCI 


Table  2.1.1.1-12:  Function  Summary  -  change_phantom_status(  status  ) 


Parameters 

Parameter 

Where  Tvoedef  Declared 

status 

1  int  1 

standard 

Function 


chanqe  status  of  menu 


Calls 


Where  Described 


this  file 


Table  2.1.1.1-13:  Function  Summary  -  change_Iogger_status(  status  ) 


Parameters 


Parameter 


status 


Function 


chq  status  of  menu  qr 


Where  Tvpedef  Declared 


standard 


Calls 


Where  Described 


this  file 


Table  2.1.1.1-14:  Function  Summary  -  change_dataprobe_status(  status  ) 


Parameters 


Parameter 


status 


Function 


chq  status  of  menu  qr 


Where  Tvoedef  Declared 


standard 


Calls 


Where  Described 


this  file 
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Table  2.1.1.1-15:  Function  Summary  -  set_menu_icon_scale(  value  ) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

value 

int 

standard 

1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

Table  2.1.1.1-16: 

Function  Summary  -  draw_setup_menu() 

1  Calls  1 

1  Function 

i  Where  Described  1 

draw  menu  this  file 


Table  2.1.1.1-17:  Function  Summary  -  draw_route_menu() 


1  Calls  1 

Function 

Where  Described 

mqlclearpln 

Concurrent  qraphics  library  subroutine 

draw  menu 

this  file 

Table  2.1.1.1-18:  Function  Summary  •  draw_catc_menu() 


Cal 

Is 

Function 

Where  Described 

unitialize  mark 

draw  routes 

draw  menu 

this  file 

set  mouse  text 

Pvd  windows.c 

mgiclearpln 

Concurrent  qraphics  library  subroutine 

check  mark 

Menu  fea.c 

Table  2.1.1.1-19:  Function  Summary  -  draw_feature_menu() 
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Table  2.1.1.1'20:  Function  Summary  -  draw_nIos_courses_menu() 


Ca 

Is 

Function 

Where  Described 

uninitialize,  mark 

draw  routes 

draw  menu 

this  file 

set  mouse  text 

Pvd  windows  c 

check,  mark 

Menu  fea.c 

Table  2.1.1.1>21;  Function  Summary  -  diavr_overlay_menu() 


1  Calls  1 

Function 

Where  Described 

draw  menu 

this  file 

overlay  mouse 

Overlavif.c 

Table  2.1.1.1-22:  Function  Summary  -  get_current_menu() 


1  Return  Values  1 

Return  Value 

Type 

current_menu 

pointer  to  MENU 

returns  pointer  to 
current  menu 

Table  2.1.1.1-23:  Function  Summary  -  init_event_flag_strings() 


1  Calls  1 

Function 

Where  Described 

pathname 

qet  db  directory 

Init  env.c 

edit  menu  strinas 

menu  fea.c 

Table  2.1.1.1-24:  Function  Summary  -  init_database_strings() 
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Functions  25  -  28  enable  access  to  their  respective  menus: 

Table  2.1.1.1-25:  Function  Summary  -  flag_activate_menu() 
This  function  enables  access  to  the  activate  menu. 


Table  2.1.1.1-26:  Function  Summary  -  flag_nIos_menu() 
This  function  enables  access  to  the  nlos  menu. 


Table  2.1.1.1-27:  Function  Summary  -  flag_stealth_menu() 

This  function  enables  access  to  the  stealth  menu. 

Table  2.1.1.1-28:  Function  Summary  -  flag_catc_menu() 
This  function  enables  access  to  the  catc  menu. 

Table  2.1.1.1-29:  Function  Summary  -  dispiay_nlos_menu() 


1  Calls  1 

Function 

Where  Described 

edit  menu  func 

menu  fea.c 

Table  2.1.1.1-30: 

Function  Summary  -  display_stealth_menu() 

1  Calls  1 

Function 

Where  Described 

edit  menu  func 

Menu  fea.c 
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Table  2.1.1.1-32:  Function  Summary  -  display_catc_menu() 


This  function  is  inactive. 


Table  2.1.1.1-33:  Function  Summary  -  set_default_menu(  menu_name  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

menu  name 

pointer  to  char 

standard 

Table  2.1.1.1-34:  Function  Summary  -  draw_default_menu() 
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2.1.2  Menu  Input  CSC  Description 

This  CSC  processes  user  commands  and  options.  It  makes  use  of  these  Utilities  CSCs, 
Text  Input/Output  (Section  3.5.2)  and  Command  Parsing  (Section  3.5.3). 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.1.2-1. 


Menu 

Input 

3.1.2 


menu_ 
lunc.c 
3. 1.2.1 


Figure  2.1.2-1:  Menu  Handling— Menu  Input  CSC  Structure. 


2. 1.2.1  nienu_func.c  CSU  Description  (/simet/pvd/Iib/pvdiface.a) 

This  CSU  contains  routines  for  managing  ail  functions  called  by  the  menu  software,  as 
defined  in  menu.c. 


Table  2.1.2.1-1:  Function  Summary  -  nop() 
This  function  performs  no  action. 


Table  2.1.2.1-2:  Function  Summary  -  menu_zoom_in() 


1  Calls  \ 

Function 

Where  Described 

handle  quickzoom 

handle  input.c 

Table  2.1.2.1-3: 

Function  Summary  -  menu_zoom_out() 

1  Calls  1 

Function 

Where  Described 

handle  zoomout 

handle  input.c 
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Table  2.1.2.1-4:  Function  Summary  •  menu_pan() 


Ca 

Is 

Function 

Where  Described 

handle  pan 

handle  input.c 

Table  2.1.2.1-5: 

Function  Summary  -  menu_zoom_125() 

1  Calls  1 

Function 

Where  Described 

handle  zoom  to  scale 

handle  input.c 

Table  2.1.2.1-6: 

Function  Summary  -  menu_zoom_50() 

1  Calls  1 

Function 

Where  Described 

handle  zoom  to  scale 

handle  input.c 

Table  2.1.2.1-7: 

Function  Summary  -  menu_zoom_25() 

1  Calls  1 

Function 

Where  Described 

handle  zoom  to  scale 

handle  input.c 

Table  2.1.2.1-8: 

Function  Summary  -  menu_top_level() 

1  Calls  1 

Function 

Where  Described 

handle  update  display 

handle  input.c 

Table  2.1.2.1-9: 

Function  Summary  -  menu_display_zoom() 

1  Calls  1 

Function 

Where  Described 

handle  display  zoom 

handle  input.c 

Table  2.1.2.1-10: 

Function  Summary  -  menu_previous_view() 

1  Calls  1 

Function 

Where  Described 

handle  previous  view 

handle  input.c 
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Table  2.1.2.1-11;  Function  Summary  -  menu_next_view() 


Calls _ 

Function  I  Where  Described 

handle  next  view  I  handle  input.c 


Table  2.1.2.1-12: 

Function  Summary  -  menu_save_zoom() 

1  Calls  1 

Function 

Where  Described 

init  workina  cursor 

Pvd  iface.c 

save  zoom 

Save  zoom.c 

init  cursor 

Pvd  iface.c 

Table  2.1.2.1-13:  Function  Summary  -  menu_cross_section{) 


I 


1  Calls  1 

Function 

Where  Described 

init  workina  cursor 

Pvd  iface.c 

cross  section 

Crosse 

clear  selected  points 

init  cursor 

PVD  iface.c 

Table  2.1.2.1-14:  Function  Summary  -  menu_colin() 


Cal 

Is 

Function 

Where  Described 

init  working  cursor 

Pvd  iface.d 

colin  cross 

Cross.c 

init  cursor 

Pvd  iface.c 

Table  2.1.2.1-15:  Function  Summary  -  menu_ruler() 


1  Calls  1 

Function 

Where  Described 

text  ruler 

Ruler.c 

Table  2.1.2.1-16:  Function  Summary  -  menu_help() 


1  Calls  1 

Function 

Where  Described 

help 

Help.c 
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Table  2.1.2.1-17:  Function  Summary  •  menu_track() 


1  Calls  1 

Function 

Where  Described 

init  track 

track.c 

Table  2.1.2.1-18: 

Function  Summary  -  menu_test_flag() 

1  Calls  1 

1  Function 

i  Where  Described  1 

send  event  flaa  i  1 

clear  selected  vehicles  i  Select.c 


Table  2.1.2.1-19:  Function  Summary  -  menu_teleport() 

Calls 

Function  I  Where  Described 

clear  selected  vehicles  Select.c 


Table  2.1.2.1-20:  Function  Summary  -  menu_area() 


1  Calls  1 

Function 

Where  Described 

aet  view  heiqht 

Get  view.c 

aet  taraet  heiaht 

Get  view.c 

aet  view  ranae 

Get  view.c 

init  workina  cursor 

Pvd  iface.c 

real  intervis  360 

Intervis. c 

init  cursor 

Pvd  iface.c 

Table  2.1.2.1-21:  Function  Summary  -  menu_veh_to_veh() 


Calls 

Function 

Where  Described 

do  vehicle  to  vehicle 

Vehicle  to  v.c 

clear  selected  vehicles 

Select.c 
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Table  2.1.2.1-22:  Function  Summary  -  menu_pt_to_veh() 


Ca! 

Is 

Function 

Where  Described 

net  view  heiaht 

Get  view.c 

net  taraet  heiaht 

Get  view.c 

aet  elevation 

Get  elev.c 

Concurrent  araphics  library  subroutine 

intervis  vehicles 

Intervis.c 

encode  force 

vehicle  to  v.c 

Table  2.1.2.1-23: 

Function  Summary  -  menu_seg_pt_to_pt() 

1  Calls  1 

Function 

Where  Described 

aet  view  heiaht 

Get  view.c 

aet  taraet  heiaht 

Get  view.c 

Table  2.1.2.1-24:  Function  Summary  -  menu_pt_to_pt() 


Cal 

Is 

Function 

Where  Described 

intervisibility 

Intervis.c 

aet  view  heiaht 

Get  view.c 

aet.  taraet  heiaht 

Get  view.c 

Table  2.1.2.1-25:  Function  Summary  -  menu_emb() 


1  Calls  1 

Function 

Where  Described 

emb  attenuate 

Intervis.c 

aet  target  height 

Get  view.c 

Table  2.1.2.1-26:  Function  Summary  -  menu_space() 


1  Calls  1 

Function 

Where  Described 

get  all  memory 

Merrxjry.c 

Table  2.1.2.1-27: 

Function  Summary  -  menu_clear() 

1  Calls  1 

Function 

Where  Described 

maiclearpln 

Concurrent  graphics  library  subroutine 

1  force  redraw  of  icons  I  Icon.c  1 

force  redraw  of  icons 
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Table  2.1.2.1-28:  Function  Summary  -  menu_intervis_clear{) 


Ca 

Is 

Function 

Where  Described 

uninitialize  mark 

mqiclearpin 

Concurrent  qraphics  library  subroutine 

clear  all  veh  to  veh 

Vehicle  to  v.c 

force  redraw  of  icons 

Icon.c 

Table  2.1.2.1-29:  Function  Summary  -  menu_steaIth_teleport() 


1  Calls  1 

Function 

Where  Described 

mqiunscalexv 

Concurrent  qraphics  lit,:ir;  subroutine 

qet  elevation 

Get  elev.c 

teleport  stealth 

Place.c 

Table 

2.1.2.1-30:  Function  Summary  - 

menu 

_stealth_teleport_and_azimuth() 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  qraphics  library  subroutine 

1  qet  elevation 

Get  elev.c 

Table  2.1.2.1-31: 

Function  Summary  •  menu_stealth_attach() 

1  Calls  1 

Function 

Where  Described 

teleport  stealth 

Place.c 

attach  stealth 

Place.c 

Table  2.1.2.1-32: 

Function  Summary  -  menu_stealth_mimic() 

1  Calls  1 

Function 

Where  Described 

map  tank  index 

qet  location 

Place.c 

teleport  stealth 

Place.c 

mimic  vehicle 

Place.c 
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Table  2.1.2.1-33:  Function  Summary  -  menu_dl_play() 


1  Calls  1 

1  Function 

Where  Described 

1111111111— — 

Loaaer  comm.c 

Table  2.1.2.1.34: 

Function  Summary  -  menu_dl_record() 

1  Calls  1 

Function 

Where  Described 

record  loaaer 

Loaaer  comm.c 

Table  2.1.2.1-35: 

Function  Summary  -  menu_dl_go() 

1  Calls  1 

Function 

Where  Described 

refresh  timestamps 

Pvd  misc.c 

check  mark 

Menu  fea.c 

continue  loaaer 

Loaaer  comm.c 

Table  2.1.2.1-36:  Function  Summary  -  menu_quit() 


Ca 

Is 

Function 

Where  Described 

pvdjoaaer  _exit 

Libptcomm.a 

chanae  loaaer  status 

Menu.c 

refresh  timestamps 

Pvd  misc.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-37:  Function  Summary  -  menu_stop() 


1  Calls  1 

Function 

Where  Described 

loaaer  stop 

Loaaer  comm.c 

Table  2.1.2.1-38:  Function  Summary  -  menu_freeze() 


Ca 

Is 

Function 

Where  Described 

loaaer  freeze 

Loaaer  comm.c 

check  mark 

Menu  fea.c 
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Table  2.1.2.1-39:  Function  Summary  -  menu_fast_forward 


Ca 

Ns 

Function 

Where  Described 

aet  typed  input 

Interact.c 

pvd  loQoer  fast  forward 

net  flush 

see  libnetif.a  in  MCC  CSCI 

Loaoer  comm.c 

Table  2.1.2.1-40:  Function  Summary  -  menu_normal_speed() 


1  Calls  1 

Function 

Where  Described 

logger  speed 

Logger  comm.c 

Table  2.1.2.1-41:  Function  Summary  -  menu_forward_abs() 


1  Calls  1 

Function 

Where  Described 

logger  seek 

Logger  comm.c 

Table  2.1.2.1-42:  Function  Summary  -  menu_rewind() 


1  Calls  1 

Function 

Where  Described 

logger  seek 

Logger  comm.c 

clear  net  input 

Pvd  misc.c 

Table  2.1.2.1-43:  Function  Summary  -  menu_forward_rel() 


1  Calls  1 

Function 

Where  Described 

logger  seek 

Logger  comm.c 

clear  net  input 

Pvd  misc.c 

Table  2.1.2.1-44:  Function  Summary  -  menu_backward_rel() 


1  Calls  1 

Function 

Where  Described 

logger  seek 

Logger  comm.c 

clear  net  input 

Pvd  misc.c 
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Table  2.1.2.1-45:  Function  Summary  -  menu_top_menu_2() 


1  Calls  1 

Function 

Where  Described 

draw  menu 

Menu.c 

Table  2.1.2.1-46: 

Function  Summary  -  menu_connect() 

1  Calls  1 

Function 

Where  Described 

draw  setuD  menu 

Menu.c 

Table  2.1.2.1-47:  Function  Summary  -  menu_overlay() 


1  Calls  1 

Function 

Where  Described 

draw  menu 

Menu.c 

Table  2.1.2.1-48:  Function  Summary  -  menu_operations() 
This  function  is  not  implemented. 

Table  2.1.2.1-49:  Function  Summary  -  menu_intelligence() 
This  function  is  not  implemented. 

Table  2.1.2.1-50:  Function  Summary  -  menu_rire_suppport() 
This  function  is  not  implemented. 

Table  2.1.2.1-51:  Function  Summary  -  menu_tac_air() 
This  function  is  not  implemented. 

Table  2.1.2.1.52:  Function  Summary  -  menu_engineer() 
This  function  is  not  implemented. 

Table  2.1.2.1-53:  Function  Summary  -  menu_red() 

This  function  is  not  implemented. 
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Table  2.1.2.1-54:  Function  Summary  -  menu_blue() 
This  function  is  not  implemented. 

Table  2.1.2.1-55:  Function  Summary  -  menu_black() 
This  function  is  not  implemented. 

Table  2.1.2.1-56:  Function  Summary  •  menu_green() 
This  function  is  not  implemented. 

Table  2.1.2.1-57:  Function  Summary  -  menu_thin() 

This  function  is  not  implemented. 

Table  2.1.2.1-58:  Function  Summary  -  menu_thick() 
This  function  is  not  implemented. 

Table  2.1.2.1-59:  Function  Summary  -  menu_dashed() 
This  function  is  not  implemented. 

Table  2.1.2.1-60:  Function  Summary  -  menu_nodify() 
This  function  is  not  implemented. 

Table  2.1.2.1-61:  Function  Summary  -  menu_not_modify() 
This  function  is  not  implemented. 

Table  2.1.2.1-62:  Function  Summary  -  menu_display() 
This  function  is  not  implemented. 

Table  2.1.2.1-63:  Function  Summary  -  menu_100x() 


Calls 

Function 

Where  Described 

check_mark 

Menu  fea.c 

set  symbolic  mode 

Icon.c 

scale  icon 

Icon.c 
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Table  2.1.2.1-64:  Function  Summary  -  menu_50x() 


Calls 


Function 

Where  Described 

check  mark 

Menu  fea.c 

set  symbolic  mode 

Icon.c 

scale  icon 

Icon.c 

Table  2.1.2.1-65:  Function  Summary  -  menu_20x() 


Calls 


Function 

Where  Described 

check  mark 

Menu  iea.c 

set  symbolic  mode 

Icon.c 

scale  icon 

Icon.c 

Table  2.1.2.1-66:  Function  Summary  -  menu_10x() 


1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

set  symbolic  mode 

Icon.c 

scale  icon 

Icon.c 

Table  2.1.2.1-67:  Function  Summary  -  menu_5x() 


Calls 


Function 

Where  Described 

check  mark 

Menu  fea.c 

set  syrr.bolic  mode 

Icon.c 

scale  icon 

Icon.c 

Table  2.1.2.1-68:  Function  Summary  •  menu_2x() 

1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

set  symbolic  mode 

Icon.c 

scale  icon 

Icon.c 
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Table  2.1.2.1<69:  Function  Summary  -  menu_lx() 


Ca 

Is 

Function 

Where  Described 

check  mark 

Menu  fea.c 

set  symbolic  mode 

Icon.c 

scale  icon 

Icon.c 

Table  2.1.2.1-70:  Function  Summary  -  menu_symbolic() 


1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

set  symbolic  mode 

Icon.c 

Table  2.1.2.1-71:  Function  Summary  -  menu_10K_m() 


Cal 

is 

Function 

Where  Described 

check  mark 

Menu  fea.c 

chanqe  arid  interval 

handle  input.c 

Table  2.1.2.1-72:  Function  Summary  -  menu_lk _ m() 


1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

chanqe  qrid  interval 

handle  input.c 

Table  2.1.2.1-73: 

Function  Summary  -  menu_500_m() 

1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

chanqe  qrid .  interval 

handle  input.c 
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Table  2.1.2.1-75:  Function  Summary  -  menu_60_m() 


1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

chanoe  contour  interval 

handle  input.c 

Table  2.1.2.1-76: 

Function  Summary  -  menu_20_m() 

1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

chanoe  contour  interval 

handle  input.c 

Table  2.1.2.1-77:  Function  Summary  -  menu_10_m() 


1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

chanoe  contour  interval 

handle  input.c 

Table  2.1.2.1-78:  Function  Summary  -  menu_5_m() 


Function 


check  mark 


chanoe  contour  interval 


Calls 


Where  Described 


Menu  fea.c 


handle  input.c 


Table  2.1.2.1-79:  Function  Summary  -  menu_set_view_height() 


Function 


et  view  heioht 


set  view  heioht 


chanoe  intervis  key  heioht 


Calls 


Where  Described 


Get  view.c 


Get  view.c 
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Table  2.1.2.1-81:  Function  Summary  -  menu_view_range() 


1  Calls  1 

Function 

Where  Described 

aet  view  ranqe 

Get  view.c 

set  view  ranqe 

Get  view.c 

chanqe  intervis  key  text 

Pvd  windows.c 

Table  2.1.2.1-82:  Function  Summary  -  menu_toggleJntervis_align() 


1  Calls  1 

Function 

Where  Described 

view  all  aliqn 

Vehicle  to  v.c 

view  ODDOsinq  aliqn 

Vehicle  to  v.c 

edit  entry 

Menu  fea.c 

Table  2.1.2.1-83: 

Function  Summary  -  menu_set_all_align() 

1  Calls  1 

Function 

Where  Described 

view  all  aliqn 

Vehicle  to  v.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-84:  Function  Summary  -  menu_set_opposing_align 


\  Calls  1 

Function 

Where  Described 

view  opposinq  aliqn 

Vehicle  to  v.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-85: 

Function  Summary  -  menu_terrain() 

1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

display  map  key 

Pvd  windows.c 

Table  2.1.2.1-86 

Function  Summary  -  menu_icon() 

1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

III  Ml  111  1 1,111 

Pvd  windows.c 
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Table  2.1.2.1-87:  Function  Summary  -  menu_nlos_hazards() 

1  Calls  1 

Function 

Where  Described 

init  workino  cursor 

Pvd  iface.c 

hiqhliqht  altitude  hazard 

New  zoom.c 

init  cursor 

Pvd  iface.c 

Table  2.1.2.1-88: 

Function  Summary  •  menu_set_altitude_hazard() 

1  Calls  1 

Function 

Where  Described 

qet  typed  input  float 

interact.c 

Table  2.1.2.1-89:  Function  Summary  -  menu_intervis() 


Ca 

is 

Function 

Where  Described 

check  mark 

Menu  fea.c 

display  inten/is  key 

Pvd  windows. c 

Table  2.1.2.1-90:  Function  Summary  -  menu_mouse_help() 


Cd 

IIS 

Function 

i  Where  Described 

check  mark 

Menu  fea.c 

display  mouse  key 

Pvd  windows.c 

Table  2.1.2.1-91:  Function  Summary  -  menu_zone() 
This  function  is  not  implemented. 


Table  2.1.2.1-92:  Function  Summary  -  menu_interactive() 
This  function  is  not  implemented. 


Table  2.1.2.1-93:  Function  Summary  -  menu_xy_plot() 
This  function  is  not  implemented. 


Table  2.1.2.1-94:  Function  Summary  -  menu_top_menu_l() 


1  Calls  1 

Function 

Where  Described 

draw  menu 

Menu.c 
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Table  2.1.2.1-95:  Function  Summary  -  menu_nIos() 


1  Calls  1 

Function 

Where  Described 

draw  menu 

Menu.c 

Table  2.1.2.1-96: 

Function  Summary  -  menu_stealth() 

1  Calls  1 

Function 

Where  Described 

draw  menu 

Menu.c 

Table  2.1.2.1-97:  Function  Summary  -  menu_contour() 


1  Calls  1 

Function 

Where  Described 

handle  contour 

handle  input.c 

Table  2.1.2.1-98: 

Function  Summary  -  menu_toggle_shade() 

Ca 

Is 

Function 

Where  Described 

toQQle  shade 

Unshade.c 

Table  2.1.2.1-99:  Function  Summary  -  menu_set_exercise() 


Cal 

is 

Function 

Where  Described 

qet  exercise 

Pvd  misc.c 

set  exercise 

Pvd  misc.c 

qet  typed  input 

Interact.c 

chanqe  exercise 

Pvd  windows. c 

Table  2.1.2.1-100:  Function  Summary  -  menu_grid() 
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Table  2.1.2.1-101:  Function  Summary  -  menu_connect_pt() 


1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

Table  2.1.2.1-102: 

Function  Summary  -  menu_dont_connect_pt() 

1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

Table  2.1.2.1-103:  Function  Summary  -  menu_connect_dl() 


1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

connect  to  loaqer 

Loqqer.comm.c 

Table  2.1.2.1-104:  Function  Summary  -  menu_disconnect_dl() 


t  Calls  1 

Function 

Where  Described 

disconnect  dl 

Loqqer.comm.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-105:  Function  Summary  -  menu_connect_dp() 


Ca 

lls 

Function 

Where  Described 

check  mark 

Menu  fea.c 
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Table  2.1.2.1-107:  Function  Summary  •  menu_done() 


Function 


init  connections 


Calls 


Where  Described 


Loaoer.comm.c 


Table  2.1.2.1-108:  Function  Summary  -  menuJogging_on() 


check  mark 


Calls 


Where  Described 


t  windows. c 


Menu  fea.c 


Table  2.1.2.1-109:  Function  Summary  -  menu_logging_off() 


Function 


check  mark 


Calls 


Where  Described 


t  windows.c 


Menu  fea.c 


Table  2.1.2.1-110:  Function  Summary  -  menu_clear_tanks() 


Function 


clear  selected  vehicles 


Calls 


Where  Described 


Select.c 


Table  2.1.2.1-111:  Function  Summary  -  menu_save_route() 


Function 


save  taroet  list 


Calls 


Where  Described 


Table  2.1.2.1-112:  Function  Summary  -  menu_route_redraw() 
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Table  2.1.2.1-114:  Function  Summary  -  menu_mode_done() 

This  function  is  not  activated  and  never  called. 

Table  2.1.2.1-115:  Function  Summary  -  goto_top_menul() 
This  function  is  not  activated  and  never  called. 

Table  2.1.2.1-116:  Function  Summary  -  back_to_menul() 


1  Calls  1 

Function 

Where  Described 

draw  menu 

Menu.c 

Table  2.1.2.1-117:  Function  Summary  -  back_to_menu2() 


1  Calls  1 

Function 

Where  Described 

draw  menu 

Menu.c 

Table  2.1.2.1-118:  Function  Summary  -  menu_catc_vehicle() 


1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

Table  2.1.2.1-119:  Function  Summary  -  menu_catc_mover_oblique() 


i  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

Table  2.1.2.1-120:  Function  Summary  -  menu_catc_mover_frontal() 


Ca 

Is 

Function 

Where  Described 

check  mark 

Menu  fea.c 
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Table  2.1.2.1-122:  Function  Summary  -  menu_catc_place_tgt() 


1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

Table  2.1.2.1-123: 

Function  Summary  -  menu_move_tgt_or_pt() 

1  Calls  1 

Function 

Where  Described 

check  mark 

Menu  fea.c 

Table  2.1.2.1-124:  Function  Summary  -  menu_save_target_list() 


1  Calls  1 

Function 

Where  Described 

save  tarqet  list 

Table  2.1.2.1-126:  Function  Summary  -  menu_list_catc_riles  () 


Function 

list  catc  tiles 


Calls 

i  Where  Described 


Table  2.1.2.1-127:  Function  Summary  -  menu_catc_transfer_file() 
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Table  2.1.2.1>129:  Function  Summary  -  menu_show_tgt_list() 


Function 


uninitialize  mark 


menu  clear 


check  mark 


draw  routes 


rt  or  catc  present 


Calls 


Where  Described 


Table  2.1.2.1>130:  Function  Summary  -  menu_catc_remove_tgt() 


Function 


remove  taraets 


check  mark 


Calls 


Where  Described 


Menu  fea.c 


Table  2.1.2.1-131:  Function  Summary  -  menu_catc_clear_tgt_list() 


Function 


clear  taraets 


Calls 


Where  Described 


Table  2.1.2.1-132:  Function  Summary  -  menu_symbol_create() 


Function 


symbol  create 


Calls 


Where  Described 


Svmbolif.c 


Table  2.1.2.1-133:  Function  Summary  -  menu_symbol_edit() 


Function 


symbol  edit 


Calls 


Where  Described 


Symbolif.c 
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Table  2.1.2.1-135:  Function  Summary  -  menu_overIine_newfeatures() 


Function 


overline  newfeatures 


Calls 


Where  Described 


Table  2.1.2.1-136:  Function  Summary  -  menu_overline_newshape() 


Function 


overline  newshape 


Calls 


Where  Described 


Table  2.1.2.1-137:  Function  Summary  -  menu_over_save() 


Function 


save  over 


Calls 


Where  Described 


Function 


read  over 


Table  2.1.2.1-138:  Function  Summary  -  menu_over_read() 


Calls 


Where  Described 


Table  2.1.2.1-139:  Function  Summary  -  menu_over_Iist() 


Function 


list  over  files 


Calls 


Where  Described 


Table  2.1.2.1-140:  Function  Summary  -  menu_over_delete() 


Function 


delete  over  files 


Calls 


Where  Described 
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Table  2.1.2.1-142:  Function  Summary  -  menu_over_edit() 


Function 


edit  over 


Calls 


Where  Described 


Table  2.1.2.1-143:  Function  Summary  -  menu_checkpt() 


Function 


controlpt  check 


Calls 


Where  Described 


Table  2.1.2.1-144:  Function  Summary  -  menu_coordpt() 


Function 


controlpt  coord 


Calls 


Where  Described 


Table  2.1.2.1-145:  Function  Summary  -  menu  conptO 


Function 


controlpt  con 


Calls 


Where  Described 


Table  2.1.2.1-146:  Function  Summary  -  menu_linkpt() 


Function 


controlpt  link 


Calls 


Where  Described 


Function 


controlpt  rel 


Table  2.1.2.1-147:  Function  Summary  -  menu_relpt() 


Calls 


Where  Described 
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Table  2.1.2.1-149:  Function  Summary  -  menu_deletept() 


Function 


controlpt  delete 


Calls 


Where  Described 


Table  2.1.2.1-150:  Function  Summary  -  menu_deleteov() 


Function 


delete  overobi 


Calls 


Where  Described 


Table  2.1.2.1-151:  Function  Summary  -  menu_reduceov() 


Function 


reduce  overobi 


Calls 


Where  Described 


Table  2.1.2.1-152:  Function  Summary  -  menu_moveov() 


Function 


move  overob 


Calls 


Where  Described 


Table  2.1.2.1-153:  Function  Summary  -  menu_addtextov() 


Function 


addtext  overobi 


Calls 


Where  Described 


Table  2.1.2.1-154:  Function  Summary  -  menu_eraseov() 


Function 


erase  overla 


Calls 


Where  Described 


Table  2.1.2.1-155:  Function  Summary  -  menu_redrawov() 
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Table  2.1.2.1-156:  Function  Summary  -  menu_resetov() 


1  Calls  1 

1  Function 

Where  Described  1 

Table  2.1.2.1-157:  Function  Summary  -  menu_change_format() 


Calls 


Function 

Where  Described 

display  utm 


Table  2.1.2.1-158:  Function  Summary  -  do_menu_event(  event  number  ) 


Parameters 


Parameter 


event  number 


Function 


send  event  fla 


clear  selected  vehicles 


Where  Typedef  Declared 


standard 


Calls 


Where  Described 


Select.c 


Table  2.1.2.1-159:  Function  Summary  -  menu_eventl() 


Function 


do  menu  event 


Calls 


Where  Described 


this  file 


Table  2.1.2.1-160:  Function  Summary  -  menu_event2() 


Function 


do  menu  event 


Calls 


Where  Described 


this  file 
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Table  2.1.2.1-162:  Function  Summary  -  menu_event4() 


1  Calls  1 

Function 

Where  Described 

do  menu  event 

this  file 

fable  2.1.2.1-163:  Function  Summary  -  menu_event5() 


1  Calls  1 

1  Function 

Where  Described 

1  do  menu  event 

this  file 

Table  2.1.2.1-164:  Function  Summary  -  menu_event6() 


1  Calls  1 

Function 

Where  Described 

do  menu  event 

this  file 

Table  2.1.2.1-165:  Function  Summary  -  menu_event7() 


:  Calls  1 

Function 

Where  Described 

do  menu  event 

this  file 

Table  2.1.2.1-166:  Function  Summary  -  menu_event8() 


1  C’lls  1 

Function 

Where  Described 

do  menu  event 

this  file 

Table  2.1.2.1-1C7:  Function  Summary  -  menu  select  vehicleO 


1  Calls  1 

Function 

Where  Described 

select  vehicle  by  name 
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Table  2.1.2.1-169:  Function  Summary  -  menu_dump_table() 


i 

1 

Calls 

1  Function 

Where  Described 

1  dump  table  to  file  1 

Table  2.1.2.1-170:  Function  Summary  -  menu_detail() 
This  function  is  not  implemented. 

Table  2.1.2.1-171:  Function  Summary  -  menu_activate() 


1  Calls  1 

Function 

Where  Described 

draw  menu 

Menu.c 

Table  2.1.2.1-172:  Function  Summary  -  menu_activate_l() 


1  Calls  1 

Function 

Where  Described 

qet  activate  mode 

activate.c 

activate  vehicle 

activate.c 

deactivate  vehicle 

activate.c 

Table  2.1.2.1-173: 

Function  Summary  •  menu_activate_2() 

1  Calls  1 

Function 

Where  Described 

get  avtivate,  mode 

activate.c 

activate  vehicle 

activate.c 

deactivate  vehicle 

activate.c 

Table  2.1.2.1-174:  Function  Summary  -  menu_activate_3() 
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Table  2.1.2.1-175:  Function  Summary  -  menu_activate_4() 


1  Calls  1 

Function 

Where  Described 

aet  activate  mode 

activate.c 

activate  vahicle 

activate.c 

deactivate  vehicle 

activate.c 

Table  2.1.2.1-176:  Function  Summary  -  menu_activate_5() 


1  Calls  1 

Function 

Where  Described 

qet  activate  mode 

activate.c 

activate  vehicle 

activate.c 

deactivate  vehicle 

activate.c 

Table  2.1.2.1-177:  Function  Summary  -  menu_activate_6() 


1  Calls  1 

Function 

Where  Described 

qet  activate  mode 

activate.c 

activate  vehicle 

activate.c 

deactivate  vehicle 

activate.c 

Table  2.1.2.1-178:  Function  Summary  -  menu_activate_7{) 


Ca 

Is 

Function 

Where  Described 

qet  activate  mode 

activate.c 

activate  vehicle 

activate.c 

deactivate  vehicle 

activate.c 

Table  2.1.2.1-179:  Function  Summary  -  menu_activate_8() 
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Table  2.1.2.1-180:  Function  Summary  -  menu_activate_9() 


1  Calls  1 

Function 

Where  Described 

qet  activate  mode 

activate.c 

activate  vehicle 

activates 

deactivate  vehicle 

activate.c 

Table  2.1.2.1-181:  Function  Summary  -  menu_activate_10() 

1  Calls  1 

Function 

Where  Described 

qet  activate  mode 

activate.c 

activate  vehicle 

activate.c 

deactivate  vehicle 

activate.c 

Table  2.1.2.1-182: 

Function  Summary  -  menu_activate_vehicle_mode() 

1  Calls  1 

Function 

Where  Described 

set  activate  mode 

activate.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-183:  Function  Summary  -  menu_deactivate_vehicle_mode() 


1  Calls  1 

Function 

Where  Described 

set  activate  mode 

activate.c 

check  mark 

Menu  tea.c 

Table  2.1.2.1-184:  Function  Summary  -  menu_altitude_l() 


1  Calls  1 

Function 

Where  Described 

set  altitude 

activate.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-185:  Function  Summary  -  menu_altitude_2() 


1  Calls  1 

Function 

Where  Described 

set  altitude 

activate.c 

check  maf1< 

Menu  fea.c 
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Table  2.1.2.1-186:  Function  Summary  -  menu_altitude_3() 


1  Calls  1 

Function 

Where  Described 

set  altitude 

activate.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-187: 

Function  Summary  -  menu_altitude_4() 

1  Calls  1 

Function 

Where  Described 

set  altitude 

activate.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-188:  Function  Summary  -  menu_altitude_5() 


1  Calls  1 

Function 

Where  Described 

set  altitude 

activate.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-189:  Function  Summary  -  menu_altitude_6() 


1  Calls  1 

Function 

Where  Described 

set  altitude 

activate.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-190:  Function  Summary  -  menu_altitude_7() 


1  Calls  1 

Function 

Where  Described 

set  altitude 

activate.c 

check  mark 

Menu  fea.c 
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Table  2.1.2.1-192:  Funci.'on  Summary  -  menu_altitude_9() 


1  Calls  1 

Function 

Where  Described 

set  altitude 

activates 

check  mark 

Menu  fea.c 

Table  2.1.2.1-193: 

Function  Summary  -  menu_altitude_10() 

1  Calls  1 

Function 

Where  Described 

set  altitude 

activate.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-194:  Function  Summary  -  menu_alt_abs{) 


1  Calls  1 

Function 

Where  Described 

set  activation  altitude  absolute 

activate.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-195:  Function  Summary  -  menu_alt_rel() 


1  Calls  1 

Function 

Where  Described 

set  activation  altitude  relative 

activate.c 

check  mark 

Menu  fea.c 

Table  2.1.2.1-196:  Function  Summary  -  menu_feature_object_info() 


Function 

object  info 
check  mark 
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Table  2.1.2.1-198:  Function  Summary  -  menu_feature_move_object() 


1  calls  1 

Function 

Where  Described 

move  objects 

check  mark 

Menu  fea.c 

Table  2.1.2.1-199:  Function  Summary  -  menu_feature_remove_object() 


1  Calls  1 

1  Function 

I  Where  Described 

1  remove  objects  1 

1  check  mark 

1  Menu  fea.c 

Table  2.1.2.1-200:  Function  Summary  -  menu_feature_save_file() 


1  Calls  1 

Function 

Where  Described 

save  feature  file 

Table  2.1.2.1-201:  Function  Summary  -  menu_feature_recall_file() 


Ca  Is 

Function _ Where  Described 

recall  teature  tile 


Table  2.1.2.1-202:  Function  Summary  -  menu_feature_list_files() 


Calls 

Function  [Where  Described 

list  feature  tiles  ~ 


Table  2.1.2.1-203:  Function  Summary  -  menu_feature_delete_file() 


Calls 

Function  I  Where  Described 

delete  feature  file  I 
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Table  2.1.2.1-204:  Function  Summary  -  menu_feature_cIear_object_Iist() 


Function 


clear  feature  list 


Calls 


Where  Described 


Table  2.1.2.1-205:  Function  Summary  -  menu_feature_redraw_objects() 


Function 


force  feature  redraw 


Calls 


Where  Described 


Table  2.1.2.1-206:  Function  Summary  -  menu_send_features() 


Function 


check  mark 


Calls 


Where  Described 


Menu  fea.c 


Table  2.1.2.1-207:  Function  Summary  -  menu_dont_send_features() 


Function 


check  mark 


set  feature  send  fia 


Calls 


Where  Described 


Menu  fea.c 


Table  2.1.2.1-208:  Function  Summary  -  menu_feature_M977() 
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Table  2.1.2.1-210:  Function  Summary  -  menu_feature_mi28() 


Function 


set  feature  type 


check  mark 


Calls 


Where  Described 


Menu  fea.c 


Table  2.1.2.1-211:  Function  Summary  -  menu_feature_new() 


Function 


set  feature  tvoe 


check  mark 


Calls 


Where  Described 


Menu  fea.c 


Table  2.1.2.1-212:  Function  Summary  -  menu_view_ground_vehicles() 


Function 


view  around  vehicles 


clear  selected  vehicles 


check  mark 


Calls 


Where  Described 


Graoh.c 


Select. c 


Menu  fea.c 


Table  2.1.2.1-213:  Function  Summary  -  menu_view_platoons() 


Function 


view  Diatoons 


clear  selected  vehicles 


check  mark 


Calls 


Where  Described 


Graoh.c 


Select.c 


Menu  fea.c 


Table  2.1.2.1-214:  Function  Summary  -  menu_view_companies() 


Function 


view  comoanies 


clear  selected  vehicles 


check  mark 


Calls 


Where  Described 


Graoh.c 


Select.c 


Menu  fea.c 


Table  2.1.2.1-215:  Function  Summary  -  menu_view_battalions() 


56 


BBN  Systems  and  Technologies 


Plan  View  Display  CSCI 


Table  2.1.2.1-216:  Function  Summary  -  menu_view_sorties() 


Function 


view  sorties 


clear  selected  vehicles 


check  mark 


Calls 


Where  Described 


Graph.c 


Select.c 


Menu  fea.c 


Table  2.1.2.1-217:  Function  Summary  -  menu_view_flights() 


Function 


view  fliahts 


clear  selected  vehicles 


check  mark 


Calls 


Where  Described 


Graph.c 


Select.c 


Menu  fea.c 


Table  2.1.2.1-218:  Function  Summary  -  menu_icon_background() 
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2.1.3  Menu  Display  Processing  CSC  Description 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2. 1.3-1. 


edit_menu.c 

3. 1.3.1 

menu_fea.c 

3. 1.3.2 


Figure  2. 1.3-1:  Menu  Handling-Menu  Display  Processing 

CSC  Structure. 


2. 1.3.1  edit_nienu.c 

This  CSU  contains  all  the  routines  which  change  the  menu  entries. 


Table  2.1.3.1-1:  Function  Summary  -  cross_menu_entry_on() 


1  Calls  1 

Function 

Where  Described 

edit  entry 

Menu  fea.c 
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Table  2.1.3.1-3:  Function  Summary  -  set_format_utm() 


1  Calls  1 

Function 

Where  Described 

edit  entry 

Menu  fea.c 

Table  2.1.3.1-4:  Function  Summary  -  set_format_xy() 


1  Calls  1 

Function 

Where  Described 

edit  entry 

Menu  fea.c 

Table  2.1.3.1-5:  Function  Summary  -  grid_menu_entry_on() 


1  Calls  1 

Function 

Where  Described 

edit  entry 

Menu  fea.c 

Table  2.1.3.1-6:  Function  Summary  -  grid_menu_entry_off() 


1  Calls  1 

Function 

Where  Described 

edit  entry 

Menu  fea.c 

Table  2.1.3.1-7:  Function  Summary  -  contour_menu_entry_on() 


1  Calls  1 

Function 

Where  Described 

edit  entry 

Menu  fea.c 

Table  2.1.3.1-8;  Function  Summary  -  contour_menu_entry_off() 


1  Calls  1 

Function 

Where  Described 

edit  entry 

Menu  fea.c 
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Table  2.1.3.1-10:  Function  Summary  -  help_menu_entry_off() 


Function 


edit  ent 


Calls 


Where  Described 


Menu  fea.c 


Table  2.1.3.1-11:  Function  Summary  -shading_menu_entry_on() 


Function 


edit  ent 


Calls 


Where  Described 


Menu  fea.c 


Table  2.1.3.1-12:  Function  Summary  -  shading_menu_entry_off() 


Function 


edit  ent 


Calls 


Where  Described 


Menu  fea.c 


Table  2.1.3.1-13:  Function  Summary  -  choose_distinguished() 
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2. 1.3.2  inenu_fea.c 

This  CSU  supports  all  menu  drawing  features,  such  as  check  marks  for  making  menu 
selections. 


Table  2.1.3.2-1:  Function  Summary  -  check_mark(  grp_name,  name,  n^enu) 


Parameters 


Parameter 


name 


name 


menu 


Function 


In 


maihue 


inter  to  char 


inter  to  char 


inter  to  MENU 


Where  Typedef  Declared 


standard 


standard 


menu.h 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.1.3.2-2:  Function  Summary  -  edit_menu_strings(grp_  name, 
old  name,  new  name,  menu,  redraw  ) 


Parameters 


Parameter 


name 


old  name 


new  name 


menu 


redraw 


Function 


et  current  menu 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  MENU 


Where  Typedef  Declared 


standard 


standard 


standard 


menu.h 


standard 


maihue 


s 


Return  Value 


entry_name 


Calls 


Where  Described 


Menu.c 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Return  Values 


NAME  LIST 


Meanin 


returns  a  pointer  to  the  new 
name  list  structure 
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Table  2.1.3.2-3:  Function  Summary  -  edit_entry(  grp  name,  old_name, 

new  name,  menu  ) 


Parameters 


Parameter 


name 


old  name 


new  name 


menu 


I  Eli? 
IIS 
IIS 
IIS 
IIS 


inter  to  char 


inter  to  char 


inter  to  char 


inter  to  MENU 


Where  Tvoedef  Declared 


standard 


standard 


standard 


menu.h 


Function 


edit  menu  strinas 


Calls 


Where  Described 


this  file 


Table  2.1.3.2-4:  Function  Summary  -  cbange_menu_func 
(  menu,  name,  func  ) 


Parameters 


Parameter 

iType _ 

Where  Typedef  Declared 

menu 

po 

inter  to  MENU 

menu.h 

name 

po 

inter  to  NAME  LIST 

menu.h 

func 

po 

inter  to  int 

standard 

Table  2.1.3.2-5:  Function  Summary  -  edit_menu_func(  grp_name, 
old  name,  new  name,  funcrmenu~) 
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2.2  ICONS  CSC  DESCRIPTION 

This  CSC  represents  individual  vehicles  on  the  PVD  by  graphics  icons  that  indicate  the 
position  and  orientation  of  the  hull  and  the  relative  orientation  of  the  turret.  It  allows  a  user 
to  vary  the  size  of  the  icons  with  the  selection  of  a  magnification  level.  A  shot  is  indicated 
by  a  line  segment  emanating  from  the  firing  vehicle.  This  CSC  also  allows  a  user  to  select 
particular  vehicles  and  obtain  detailed  information  such  as  the  vehicle  location,  speed, 
alignment,  identification  number,  and  repair  and  supply  status. 

This  CSC  allows  a  user  to  vary  the  size  of  an  icon  with  the  selection  of  a  magnification 
level. 

By  default,  the  PVD  displays  vehicles  in  exercise  1.  The  user  can  display  vehicles  in  a 
different  exercise  by  supplying  a  different  exercise  number. 

This  CSC  functionality  is  broken  down  into  lower-level  CSCs  shown  in  Figure  2-2. 


Figure  2-2: 


Icons  CSC  Structure. 


BBN  Systems  and  Technologies _ Plan  View  Display  CSC! 

2.2.1  Icon  Draw  and  Display  CSC  Description 

This  lower-level  CSC  provides  the  processing  for  icon  drawing  and  displays. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.2.1-1.  Icon 
selection  functionality  is  also  supported  by  the  CSU,  select  .c.  (Section  3.5.5.*). 


Icon 

Draw& 

Display 

3.2.1 


graph.c 

3.2.1. 1 

icon_fea.c 

3.2. 1.2 


dir_fire.c 

3.2.1. 3 

indir_ 

fire.c 

3.2. 1.4 

class.c 

3.2. 1.5 

lase.c 

3.2.1. 6 

effects.c 

3.2. 1.7 


Figure  2.2.1-1:  Icons-Icon  Draw  &  Display  CSC  Structure. 

2.2. 1.1  graph.c 

This  CSU  controls  the  graphics  display  of  vehicle  states  for  use  with  Plan  View  Display. 

Table  2.2.1.1<1:  Function  Summary  -  set_distinguished() 

This  function  is  not  used. 
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Table  2.2. 1.1-2:  Function  Summary  -clear  distinguishedO 

This  function  is  not  used. 

Table  2.2.1. 1-3:  Function  Summary  -  view_ground_vehicIes() 
This  function  is  not  used. 

Table  2.2.1. 1-4:  Function  Summary  -  view_pIatoons() 

This  function  is  not  used. 

Table  2.2.1.1-5  Function  Summary  -  view_companies() 

This  function  is  not  used. 

Table  2.2. 1.1-6:  Function  Summary  -  view_battalions() 

This  function  is  not  used. 

Table  2.2.1. 1-7:  Function  Summary  -  view_sorties() 

This  function  is  not  used. 

Table  2.2.1. 1-8:  Function  Summary  •  view_nights() 

This  function  is  not  used. 

Table  2.2.1. 1-9  Function  Summary  -  query_view_mode(  veh  index  ) 
This  function  is  not  used. 
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Table  2.2.1.1-10  Function  Summary  -  Update_Graphics_DispIay 
(worId_state,  current_time  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

world_state 

pointer  to  struct 

WORLD  STATE 

world_state.h 

current  time 

int 

standard 

Ca 

Is 

Function 

Where  Described 

headina 

Measures.c 

rel  turret 

Measures. c 

heading  fraction 

Measures.c 

get.  turret  degrees 

Text.c 

Concurrent  graphics  library  subroutine 

1  setup  back  fb 

New  zoom.c 

Concurrent  graphics  library  subroutine 

mgibbgetview 

Concurrent  graphics  library  subroutine 

mmgibblt2 

Concurrent  graphics  library  subroutine 

mgiv 

Concurrent  graphics  library  subroutine 

mgifbfbex 

Concurrent  graphics  library  subroutine 

mgisyncrb 

Concurrent  graphics  library  subroutine 

mg  j  mode 

Concurrent  graphics  library  subroutine 

print  vehicle  id 

Pvd.misc.c 

2.2. 1.2  icon  fea.c 


This  CSU  draws  the  roaming  unit  symbols.  (It  is  not  used  in  the  training  sites,  and  not 
supported  in  training  software.) 


2.2. 1.3  dir_fire,c 

This  CSU  contains  routines  for  processing  impact  PDUs  and  updating  the  event  window 
with  vehicle  and  ground  impact  information. 


Table  2.2.1.3-1:  Function  Summary  -  do_impact(impact) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

impact 

pointer  to  ImpactVariant 

p  sim.h 

Ca 

Is 

Function 

Where  Described 

find  icon 

Icon.c 

print  vehicle  id 

Pvd.misc.c 

save  impact  info 

Dir  fire.c 

show  firing  line 

Dir  fire.c 

set  text  window 

indir  fire.c 
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Table  2.2. 1.3-2:  Function  Summary  -  save_impact_info(  attacker_id, 
impact_x,  impact_y,  attack^x,  attack_y  ) 


Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

attacker  id 

int 

standard 

impact  X.  i 


standard 


standard 


Return  Value 


1 


Return  Values 


Meanin 


successful 


failed 


Table  2.2.1.3-3:  Function  Summary  -  show_firing  line(  tank,  impact_x, 

impact_y,  attack_x,  attack  y  1 


Parameter 


tank 


EiBBEiiman 


Parameters 


e 


ICONPTR 


float 


float 


Where  Tvpedef  Declared 


icon  dfn.h 


standard 


standard 


Function 


mqimode 


In 


maihue 


mqisyncrb 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Table  2.2. 1.3-4:  Function  Summary  -  check_firing_duration 


Function 


In 


mqimode 


mqihue 


mqisyncrb 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 
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Table  2.2.1.3-5:  Function  Summary  -  decode_ammo_type(  burst  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

burst 

pointer  to  BurstDescriptor 

basic,  h 

1  Calls  1 

Function 

Where  Described 

decode  specific  ammo  type 

this  file 

decode  aeneric  ammo  type 

this  file 

1  Return  Values  1 

Return  Value 

Type 

Meaning  I 

“ammo” 

char 

I'll 

Table  2.2.1.3-6:  Function  Summary  - 
decode_generic_ammo_type(object_type  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

object  type 

1  ObjectType  I 

p  sim.h 

Table  2.2.1.3-7:  Function  Summary  - 

decode_specific_ammo_type(object_type  ) 


Parameter 


object  tvoe 


Parameters 


OblectTvoe 


Where  Tvpedef  Declared 


sim.h 


Return  Values 


Return  Value 


M791  25mm  AP 


M792  25mm 


M789  30mm  HEDP 


M392A2  105mm  APDS 


M456A1  105mm  HEAT 


M329  107mm  HE 


M107155mm  HE 


M855  5.56mm  bullet 


Mk82  5001b  bomb 


TOW  missile 


M47  Draoon  missile 


Hellfire  missile 


Maverick  missile 


Sidewinder  missile 


ADATS  missile 


Stinoer  missile 


Tomahawk  missile 


Styx  C  missile 


S-5  57mm  rocket 


Meanin 


object  type 


object  type 


object  type 


object  type 


object  tvoe 


object  type 


object  type 


object  type 


object  type 


missile 


missile 


missile 


missile 


missile 


missile 


missile 


missile 


Soviet  missile 


Soviet  missile 
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Table  2.2.1.3>8:  Function  Summary  •  decode_resuIt(  result  ) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

result 

int 

standard 

1  Return  Values  1 

Return  Value 

Meaning 

nothina 

char 

nonimpact 

around 

char 

aroundimpact 

vehicle 

char 

vehicleimpact 

illeaal-taraet 

char 

default 

2.2. 1.4  indir_fire.c 

This  CSU  contains  routines  for  processing  indirect  fire  PDUs  and  displaying  various  types 
of  fire  burst  icons. 


Table  2.2.1.4-1:  Function  Summary  •  init_bursts() 


This  function  contains  arrays  to  hold  segments  for  burst  icons. 


Calls 

Function 

t  Where  Described 

create  all  burst  seas  this  file 


Table  2.2.1.4>2:  Function  Summary  -  do_direct_fire  (indir_fire_pkt  ) 


Parameters 


Parameter 


indir  fire  okt 


inter  to  IndirectFireVariant 


Where  Tvpedef  Declared 


sim.h 


Calls 

Function 

Where  Described 

report  ifire  to  screen 

this  file 

do  firefinder 

this  file 

draw  bursts 

this  file 
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Table  2.2.1.4-3:  Function  Summary  -  reportjfire_to_screen(  i_pkt  ) 


Parameter 


kt 


Parameters 


Where  Tvoedef  Declared 


inter  to  IndirectPireVariant  p  sim.h 


Calls 


Function 

Where  Described 

set  text  window 

this  file 

Table  2.2.1.4-4:  Function  Summary  •  pr_ifire_map_coords(  ipkt  ) 


Parameter 


kt 


Function 


set  text  window 


status  stam 


et  utm 


Parameters 


e  Where  Tvpedef  Declared 


inter  to  IndirectPireVariant  p  sim.h 


Calls 


Where  Described 


this  file 


see  libtdb  in  MCC  CSCI 


Table  2.2.1.4-5:  Function  Summary  •  draw_bursts 
(  type_burst,  i^pkt,  color  ) 

This  function  draws  the  string  of  bursts  as  specified  by  i_pkt  and  type_burst. 
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Table  2.2.1.4-6:  Function  Summary  -  create_all_burst_segs(  burst_scale  ) 


Parameters 


Parameter 


burst  scale 


Where  Tynedef  Declared 


standard 


Calls  1 

Function 

Where  Described 

create  burst  seqment 

this  file 

Table  2.2.1.4-7:  Function  Summary  -  create_burst_segment 
(  burst_array,  scale_factor,  burst_scale  ) 


Parameters 


Parameter 


burst  arra 


scale  factor 


burst  scale 


Function 


moibse 


maiese 


inter  to  Ion 


real 


real 


Where  Tvoedef  Declared 


standard 


standard 


standard 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Table  2.2.1.4«8:  Function  Summary  -  save_indir_rire_info(  i_pkt  ) 

This  function  stores  the  PDU  information  in  the  BurstDesc  array. 


Parameter 


kt 


Return  Value 


YES 


NO 


Parameters 


e  Where  Tvpedef  Declared 


inter  to  IndirectFireVariant  I  o  sim.h 


Return  Values 


Meanin 


successful 


failed 


Table  2.2.1,4-9:  Function  Summary  -  check_burst_duration() 


Function 


draw  bursts 


Calls 


Where  Described 


this  file 
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Table  2.2.1.4-10;  Function  Summary  -  erase  all  burstsQ 


1  Calls  1 

Function 

Where  Described 

draw  bursts 

this  file 

Table  2.2.1.4-11:  Function  Summary  -  check_det(  det  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

det 

piointer  to  IndirectFireDeton- 
ation 

p_sim.h 

1  Return  Values  1 

Return  Value 

Meanina 

1 

int 

successful 

0 

int 

failed 

Table  2.2.1.4-12:  Function  Summary  -  set_firefinder() 
This  function  sets  the  mode  that  turns  on  the  firefinder  feature. 


2.2. 1.5  class. c 


This  file  contains  routines  for  classifying  objects  into  one  of  the  display  types  that  PVD  can 
draw  (such  as  vehicle,  missile,  building,  or  unknown  object.) 


Table  2.2.1.5-1:  Function  Summary  -  classify_object(  object_type  ) 
Given  a  Simnet  object  type,  this  routine  returns  a  PVD  draw  type. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

object  type 

ObjectType 

p  sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

classify  vehicle 

int 

object  DomainVehicle 

ICON  MISSILE 

int 

object  DomainMunition 

ICON  BUILDING 

int 

object  DomainStructure 

ICON  STEALTH 

int 

default 

ICON  UNKNOWN 

int 

default 

1  Calls  1 

Function 

Where  Described 

classify  vehicle 

this  file 
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Table  2.2. 1.5-2:  Function  Summary  -  classify_vehicle(  object_type  ) 
This  function  prints  inforr  i...  .  from  the  LaserRangeVariant  in  the  event  window. 


Parameter 


object  type 


Parameters 


unsioned  Ion 


Where  Tvoedef  Declared 


standard 


Return  Value 


round  vehicle 


classify  air  vehicle 


classify  water  vehicle 


ICON  GROUND  VEHICLE 


Return  Values 


Meanin 


vehicleEnvironmentGround 


vehicleEnvironmentAir 


vehicleEnvironmentWater 


default 


Function 


round  vehicle 


classifv  air  vehicle 


classify  water  vehicle 


Calls 


Where  Described 


Class.c 


Class.c 


Class.c 


Table  2.2.1.S-3:  Function  Summary  -  classify  ground  vehicle 

(object_type) 
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Table  2.2. 1.5-4:  Function  Summary  -  classify_air_vehicle(  object_type  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

object  type 

unsiqned  lonq 

standard 

1  Return  Values  1 

Return  Value 

Meanina 

ICON  FIXED  WING 

int 

vehicleClassFixedWina 

ICON  ROTARY  WING 

int 

vehicleClassRotarvWinq 

ICON  FIXED  WING 

int 

default 

Table  2.2.1.S-5:  Function  Summary  -  classify_water_vehicle(  object  type  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

object  type 

unsiqned  lonq 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meanlnq 

ICON  SMALL  SHIP 

int 

vehicleFunctionCruiser 

ICON  MEDIUM  SHIP 

int 

vehicleFuncticnBattleship 

ICON  LARGE  SHIP 

int 

vehicleFunctionCarrier 

ICON  SMALL  SHIP 

int 

default 

Table  2.2. 1.5-6:  Function  Summary  -  knots_object(  object  ) 

This  function  returns  1  if  this  is  a  vehicle  whose  velocity  should  be  reponed  in  knots  (ships 
and  aircraft.) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

object 

ObjectType 

p  sim.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

int 

other 

1 

int 

This  is  a  vehicle  whose  vebdty 
should  be  reported  in  knots 
(aircraft  and  ships.) 

2.2. 1.6  lase.c 

This  file  handles  the  receipt  of  a  LaserRange  PDU.  It  prints  information  from 
LaserRangeVariant  in  the  event  window. 
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Table  2.2.1.6-1:  Function  Summary  -  lase(  l_variant  ) 


Parameter 


I  vanant 


Parameters 


e  Where  Tvnedef  Declared 


inter  to  LaserRanaeVariant  I  d  data.h 


Calls 


Function 

Where  Described 

display  lase 

this  file 

draw  laser 

this  file 

Table  2.2.1.6-2:  Function  Summary  -  dispiay_lase(  Invariant  ) 
This  function  prints  information  from  LaserRange Variant  in  the  event  window. 


Parameter 


I  variant 


Function 


tdb  aiv  XV  aet  utm 


dist  3 


set  text  window 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  LaserRanaeVariant  p  data.h 


Calls 


Where  Described 


see  libtdb  in  MCC  CSCI 


Measures.c 


indir  fire.c 


Table  2.2.1.6<3:  Function  Summary  -  draw_laser(  laser_packet  ) 


Parameter 


laser  packet 


Function 


save  laser  info 


show  laser  beam 


Parameters 


e  Where  Tvpedef  Declared 


inter  to  LaserRanaeVariant  I  p  data.h 


Calls 


Where  Described 


this  file 


this  file 


Table  2.2.1.6-4:  Function  Summary  -  save_laser_info(  laser_x,  Iaser_y, 

muzzle_x,  muzzle_y  ) 
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Table  2.2. 1.6-5:  Function  Summary  -  show_laser_beam(  laser_x,  laser_y, 

muzzle_x,  muzzle_y  ) 


1  Parameters  1 

1  Parameter 

Where  Tvpedef  Declared 

float 

standard 

float 

standard 

Ca 

lls 

Function 

Where  Described 

maiv 

Concurrent  araphics  library  subroutine 

maimode 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

maihue 

Concurrent  araphics  library  subroutine 

marl 

Concurrent  araphics  library  subroutine 

maisyncrb 

Concurrent  araphics  library  subroutine 

Table  2.2.1.6-6:  Function  Summary  •  check_lasing_duration() 


Ca 

Is 

Function 

Where  Described 

maiv 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

maimode 

Concurrent  araphics  library  subroutine 

maihue 

Concurrent  araphics  library  subroutine 

mqrl 

Concurrent  araphics  library  subroutine 

mpisycrb 

Concurrent  oraphics  library  subroutine 

2.2. 1.7  effects. c 

This  CSU  provides  a  mechanism  to  interrupt  icon  processing  to  respond  to  user  commands 
in  a  timely  fashion.  Update_Graphics_DispIay  calls  move_icon  for  each  vehicle  icon  on 
the  current  map.  This  file  also  supports  icon  updating. 


Table  2. 2. 1.7-1:  Function  Summary  -  init_effects() 


1  Calls  1 

Function 

Where  Described 

create  puff  sea 

this  file 

Table  2.2. 1.7-2:  Function  Summary  -  create_puff_seg() 


Function 


maibse 


moimode 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 
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2.2.2  Icon  Detail  CSC  Description 


This  CSC 


provides  icon  information  in  a  separate  display. 


This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.2.2- 1. 


Icon 

Detail 

3.2.2 


stat_ 

change.c 

3.2.2.1 


Figure  2.2.2-1: 


Icons-Icon  Detail  CSC  Structure. 


2.2.2. 1 


stat_change.c 


This  file  contains  routines  for  handling  status  change  packets  for  vehicle  icons.  It  prints 
messages  in  the  event  window  indicating  the  arrival  of  a  status  change  packet,  containing 
information  about  type  of  vehicle,  vehicle  id,  status  (such  as  damaged,  destroyed,  or 
repaired),  and  damage  cause. 

Table  2.2.2. 1*1:  Function  Summary  -  display_status_change 

(status_change  ) 

This  function  displays  a  message  in  the  event  window  indicating  the  arrival  of  a  status 
change  packet. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

status  change 

pointer  to  StatusChangeVariant 

p_  data.h 

1  Calls  1 

Function 

Where  Described 

decode  damage  cause 

this  file 

decode  repair  cause 

this  file 

set  text  window 

indir  fire.c 

print  vehicle  id 

Pvd  misc.c 
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Table  2.2.2.1-2:  Function  Summary  -  decode_damage_cause(  damage  ) 


1  Parameters  i 

Parameter 

Type 

Where  Typedef  Declared 

damaae 

int 

standard 

1  Return  Values  1 

Return  Value 

Meanina 

cause 

char 

Pri  nts  cause ;  u  nspecif ied 
cause;  random  failure;  collision 
with  vehicle;  crew  error;  direct 
fire;  indirect  fire;  operator 
intervention;  collsionwith 
terrain;  unknown  causes. 

Table  2.2.2. 1-3:  Function  Summary  •  decode_repair_cause(  repair  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

repair 

int 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meanlnq 

cause 

char 

Prints  cause: 
unspecified  causes;  crew 
action;  operator  intervention; 
simulated  maintenance  team; 
unknown  causes. 
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2.2.3  Initial  Icons  CSC  Description 
This  CSC  is  the  main  entry  for  Icons. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.2.3- 1. 

Initial 

Icons 

3.2.3 


icon.c 

3.2.3. 1 

detail.c 

3.2.3.2 


Figure  2.2.3-1:  Icons-Initial  Icons  CSC  Structure. 

2.2.3. 1  icon.c 

This  CSU  includes  the  functions  for  creating,  scaling,  drawing  and  erasing  all  icons  that 
appear  on  the  map  (representing  vehicles,  artillery  impacts,  etc.).  The  icon  shapes  are 
defined  in  icon_dfn.h. 


Table  2.2.3.1-1:  Function  Summary  -  nnd_icon(  vehicle_id  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

vehicle  id 

pointer  to  VehiclelD 

basic.h 

1  Return  Values  1 

Return  Value 

Meaning 

null 

ICONPTR 

no  icon  for  given  vehicle  id 

tanks!  vehicle  index  1 

ICONPTR 

array  of  icon  pointers 

1  Calls  1 

Function 

Where  Described 

get  vehicle  index 

Hash  fn.c 
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Table  2.2.3.1>2:  Function  Summary  -get_icon_from_bumper(  bumper  str  ) 


Given  the  bumper  number  of  an  icon,  this  function  returns  the  corresponding  index. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

bumper  str 

pointer  to  char 

standard 

Table  2.2.3.1-3:  Function  Summary  -  create_icon(vehicle_index  ) 


This  function  stores  the  vehicle  id  as  well  as  the  bumper  number.  If  there  is  no  bumper 
number,  a  string  of  the  form  “ID:  vehicle  id”  will  be  stored. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

vehicle  index 

int 

standard 

Table  2.2.3. 1-4:  Function  Summary  -  erase_old_tank(  tank  ) 

This  function  erases  an  old  tank  from  the  screen.  It  assumes  in  ABSOLUTE  mode  upon 
entering  and  leaving  the  routine. 


Parameter 


tank 


Parameters 


reaister  ICONPTR 


Where  Tvpedef  Declared 


icon  dtn.h 


Calls 

Function 

Where  Described 

mgimode 

Concurrent  oraphics  library  subroutine 

moimode 


maihue 


erase  old  feature  icon 


display  attachment 


mqiseaimm 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


this  file 


Concurrent  oraphics  library  subroutine 


Table  2.2.3. 1-5:  Function  Summary  -  create_smoke_seg() 

This  is  the  segment  for  displaying  the  smoke  vehicle.  There  will  be  only  one  segment, 
regardless  of  effect  bits  and  size.  This  function  performs  scaling  based  on  icon  scale. 
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Table  2.2.3. 1*6:  Function  Summary  •  create_minefield_flag() 

This  is  the  segment  for  displaying  minefield  flags.  Breech  lane  flags  are  white,  minefield 
flags  are  red. 


Function 


maibse 


imode 


In 


maiese 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.2.3. 1-7:  Function  Summary  -  create_hl_seg() 

This  function  creates  a  highlighting  box  such  that  the  icon  can  fit  inside  it  regardless  of  the 
icon’s  orientation. 


Function 


maibse 


il 


main 


maiese 


Function 


maibse 


maimode 


ils 


maibox 


maiese 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.2.3.1-8:  Function  Summary  -  create_bore_seg() 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.2.3.1-9:  Function  Summary  -  create_plane_segs() 

A 10  icon  is  created  assuming  in  relative  mode.  Thus,  the  center  of  the  icon  is  0,0. 
Everything  is  calculated  relative  to  the  center.  Dimensions  used  are:  wingspan  60  feet, 
length  50  feet. 
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Table  2.2.3.1-10:  Function  Summary  -  create_hull_segs() 

Hull  is  created  assuming  relative  mode.  Thus,  the  center  of  the  hull  is  0,0.  Everything  is 
calculated  relative  to  the  center.  Hull  is  a  5  x  9  rectangle. 


Function 


maibse 


moiese 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.2.3.1-11:  Function  Summary  -  create_turret_segs() 

This  function  creates  a  segment  for  the  turret.  Cannon  are  drawn  relative  to  the  turret  body. 
It  assumes  in  relative  mode  upon  entering  the  segment. 


Function 


moiese 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.2.3.1-12:  Function  Summary  -  create_m2_hull_segs() 

Hull  is  created  assuming  relative  mode.  Thus,  the  center  of  the  hull  is  0,0.  Everything  is 
calculated  relative  to  the  center.  Hull  is  a  4  x  7  rectangle. 


Function 


moibse 


i5u?l 


moiese 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.2.3.1-13:  Function  Summary  -  create_m2_turret_segs() 

This  function  creates  a  segment  for  the  turret.  Cannon  are  drawn  relative  to  turret  body.  It 
assumes  in  relative  mode  upon  entering  the  segment 
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Table  2.2.3.1-14:  Function  Summary  -  create_static_stripe_segs() 

This  function  creates  a  segment  for  the  stripe  on  MCC  vehicles.  The  stripe  is  drawn  relative 
to  the  hull  body.  It  assumes  in  relative  mode  upon  entering  the  segment. 


Function 


maibse 


maiese 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  araDhics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.2.3.1-15:  Function  Summary  -  create_faad_turret_segs() 

This  function  creates  a  segment  for  the  turret.  Cannon  are  drawn  relative  to  the  turret  body. 
It  assumes  in  relative  mode  upon  entering  the  segment. 


Function 


moibseos 


maiese 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.2.3.1-16:  Function  Summary  -  create_rwa_body_segs() 


Function 


moibse 


i7tI4 


maiese 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.2.3.1-17:  Function  Summary  -  create_rwa_prop_segs() 

This  function  creates  a  segment  for  the  rwa  prop  and  tail.  It  is  drawn  relative  to  the  rwa 
body.  It  assumes  in  relative  mode  upon  entering  the  segment. 
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Table  2.2.3.1-18:  Function  Summary  -  create_rwa_hl_segs() 

This  function  calculates  segments  for  the  rwa  highlight  box.  Since  the  RWA  icon  is 
asymmetric,  its  highlight  box  must  be  rotated  ba^  on  its  orientation. 


Function 


maibse 


ils 


moiese 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  Kbrary  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.2.3.1-19:  Function  Summary  -  create_stealth_segs() 

The  Stealth  icon  will  be  an  arrow  pointing  in  the  direction  of  travel.  When  it  is  attached,  a 
circle  will  be  displayed  when  the  Stealth  is  attached  to  a  specific  vehicle. 


Function 


mqibse 


moiwidth 


maitl 


maiese 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.2.3.1-20:  Function  Summary  -  create_bfit_segs(  model_typc  ) 

Hull  is  calculated  assuming  relative  mode.  Thus,  the  center  of  the  hull  is  0,0.  Everything  is 
calculated  relative  to  the  center.  Hull  is  a  20  x  200  rectangle. 
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Table  2.2.3.1-21:  Function  Summary  -  create_brit_stripe_ 

segs(  modeI_  type)  ~ 

This  function  creates  a  segment  for  the  stripe  on  vehicles.  Stripe  is  drawn  relative  to  the 
hull  body.  It  assumes  in  relative  mode  upon  entering  the  segment. 


Parameters 

Parameter 

Where  Typedet  Declared 

model  type 

1  int  1 

standard 

Function 


maiese 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Table  2.2.3.1-22:  Function  Summary  -  create_bfit_hl_segs(  model_type  ) 

This  function  calculates  segments  for  the  asymmetric  highlight  box.  Since  the  icons  are 
asymmetric,  its  highlight  box  must  be  rotat^  based  on  its  orientation. 


Parameters 


Parameter 


model  type 


Function 


ilS 


maiese 


Where  Typedet  Declared 


standard 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.2.3.1-23:  Function  Summary  -  dispiay_attachment(  hue  ) 

The  highlight  for  stealth  attach  is  a  circle  of  radius  9.  This  is  just  big  enough  to  fit  around 
the  highlight  box.  It  assumes  current  position  is  the  center  of  the  vehicle. 


Parameters 


Parameter 


hue 


Where  Tyoedef  Declared 


standard 


Calls  j 

Function 

Where  Described 

maihue 

Concurrent  araphics  library  subroutine 

maiwidth 

Concurrent  araphics  library  subroutine 

maitc 

Concurrent  araphics  library  subroutine 
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Table  2.2.3.1-24:  Functiou  Summary  -  create_attachment_icon(veh_ind  ) 


Parameters 


Parameter 


veh  ind 


Where  Tvoedef  Declared 


standard 


Function 


IV 


In 


maihue 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.2.3.1-25:  Function  Summary  -  delete_attacbment_icon(veh_ind  ) 


Parameters 


Parameter 


veh  ind 


Where  Tvpedef  Declared 


standard 


Function 


In 


maihue 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.2.3.1-26:  Function  Summary  -  reinit_all_icons() 


Function 


erase  all 


maisyncrb 


Calls 


Where  Described 


indir.tire.c 


Concurrent  araphics  library  subroutine 


Table  2.2.3.1-27:  Function  Summary  -  delete_icon(  tank_ind  ) 


Parameter 


tank  ind 


Parameters 


Where  Typedef  Declared 


standard 


Function 


erase  old  tank 


erase  whole  trail 


hiahliaht  icon 


isyncrb 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


this  file 


this  file 


this  file 


Concurrent  araphics  library  subroutine 
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Table  2.2.3.1-28:  Function  Summary  -  move_icon(  tank_ind,  type, 
appearance,  force,  hulMndex,  turret_index,  x,  y  ) 


This  function  supports  a  vehicle  changing  its  “alignment  “  (force)  and  appearance  (guise) 
without  deactivating.  The  change  of  guise  can  result  from  the  PVD  changing  its  view  from 
the  “distinguished”  force. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

tank  ind 

int 

standard 

ObiectType 

D  sim.h 

unsiqned  lonq 

standard 

force 

ForcelD 

basic.h 

hull  index 

int 

standard 

turret  index 

int 

standard 

JLl _ 

double 

standard 

Ca 

Is 

Function 

Where  Described 

query  view  mode 

Graph.c 

move  feature  icon 

classify  object 

Class.c 

mqiv 

Concurrent  qraohics  library  subroutine 

Concurrent  qraohics  library  subroutine 

hiqhliqht  icon 

this  tile 

mqisyncrb 

Concurrent  qraohics  library  subroutine 

Table  2.2.3.1-29:  Function  Summary  -  check_vehicle_type(  tank  ) 


This  function  checks  the  vehicle  type  to  see  if  it  has  changed  from  a  dead  tank  to  an  active 
one  or  vice  versa.  If  there  is  a  change,  the  function  changes  the  color  appropriately. 
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Table  2.2.3.1-30:  Function  Summary  -  swap_colors(  tank  ) 


This  function  swaps  the  hull  and  turret  colors  when  the  vehicle  type  changes.  It  also 
toggles  the  vehicle  status. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

tank 

reqister  ICONPTR 

icon  dfn.h 

Table  2.2.3.1-31:  Function  Summary  -  assign_colors(  tank,  force  ) 
This  funcdon  initializes  the  colors  of  the  hull  and  turret  and  initializes  the  status. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

tank 

reqister  ICONPTR 

icon  dfn.h 

force 

ForcelD 

basic. h 

Table  2.2.3.1-32:  Function  Summary  -  highlight_icon(  icon,  hue  ) 

This  function  highlights  a  particular  icon  by  drawing  it  in  the  color,  hue.  The  highlighting 
box  can  be  removed  by  using  hue  =  0. 
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Table  2.2.3.1-33:  Function  Summary  -highlight_  selectedjcon 

(vehicie_index  )  ~ 

This  function  is  called  by  the  user  interface  to  let  the  icon  routines  know  that  the  icon  has 
been  highlighted. 


Parameters 


Parameter 


vehicle  index 


Where  Typedef  Declared 


standard 


1  Calls 

Function 

Where  Described 

mgiv 

Concurrent  graphics  library  subroutine 

In 


icon  heiaht 


mqiseaimm 


Concurrent  araohics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.2.3.1-34:  Function  Summary  -  unhighlight_selected_icon 

(vehicle_index  )  ~ 

This  function  is  called  by  the  user  interface  to  let  the  icon  routines  know  that  highlighting 
has  been  turned  off  for  the  icon.  This  has  the  possibility  of  putting  a  streak  through  an  icon 
if  there  is  one  nearby.  Therefore,  to  minimize  the  possibility  of  this  happening,  do  not  erase 
highlighting  box  unless  there  definitely  is  one. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

vehicle  index 

int 

standard 

Return  Values 


Return  Value 


Type 


Meaning 


yes 


int 


highlighting  turned  oft 


1  Calls  1 

Function 

Where  Described 

mgiv 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

1  highlight  icon 

this  file 

Table  2.2.3.1-35:  Function  Summary  -  draw_tank(  hull_orient, 

turret  orient,  tank) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

hull  orient 

int 

standard 

turret  orient 

int 

standard 

tank 

register  ICONPTR 

icon  dfn.h 
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Ca 

Is 

Function 

Where  Described 

display  attachment 

this  file 

maihue 

Concurrent  araphics  library  subroutine 

maimode 

Concurrent  araphics  library  subroutine 

maiseaimm 

Concurrent  araphics  library  subroutine 

Table  2.2.3.1-36:  Function  Summary  -  init_icon_coIors() 


1  Calls  1 

1  Function 

Where  Described  1 

lull'll  1' li  lii  IMBM 

1  make  color  map 

Color  map.c  1 

Table  2.2.3.1-37:  Function  Summary  -  init_icons() 


1  Calls  1 

Function 

Where  Described 

calc  initial  icon  size 

this  file 

calc  screen  scales 

this  file 

create  rwa  hi  seas 

this  file 

create  hull  seas 

this  file 

create  turret  seas 

this  file 

create  bore  sea 

this  file 

create  plane  seas 

this  file 

create  smoke  sea 

this  file 

create  minefield  flap 

this  file 

create  faad  turret  seas 

this  file 

create  m2  hull  seas 

this  file 

create  m2  turret  seas 

this  file 

create  static  stripe  seas 

this  file 

create  rwa  body  seas 

this  file 

create  rwa  prop  seas 

this  file 

create  stealth  seas 

this  file 

create  bfit  seas 

this  file 

create  bfit  stripe  seas 

this  file 

create  bfit  hi  seas 

this  file 

create  feature  icons 

show  icon  scale 

Pvd  windows. c 

Table  2.2.3.1-38:  Function  Summary  -  set_distinguished_colors() 
This  function  is  not  used. 


Table  2.2.3.1-39:  Function  Summary  -  set_other_coIors() 
This  function  is  not  used. 
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Table  2.2.3.1-40:  Function  Summary  -  make_coIor_array(  color_array  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

color  array 

1  pointer  to  long  I 

standard 

Table  2.2.3.1-41:  Function  Summary  -  draw_trail(  tank,  force,  x,  y  ) 

The  trail  for  each  tank  is  composed  of  an  array  of  points.  The  arrays,  x_trail  and  y_trail  are 
arrays  of  floats  which  are  the  x  and  y  coordinates  for  the  trail  of  each  tank.  The  indices  of 
x_tr^  and  y_trail  indicate  which  tank’s  trail  is  being  accessed.  Each  trail  length  is  the 
number  of  points  specified  by  NUM_POINTS  in  “icons_dfn.h.” 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

tank 

register  ICONPTR 

icon  dfn.h 

force 

ForcelD 

basic.h 

hi _ 

float 

standard 

1  Calls  1 

Function 

Where  Described 

mgimode 

Concurrent  graphics  library  subroutine 

assign  colors 

this  file 

init  trail 

this  file 

mgihue 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

Table  2.2.3.1-42:  Function  Summary  -  erase_trail(  tank  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

tank 

register  ICONPTR 

icon  dfn.h 

1  Calls  1 

Function 

Where  Described 

mgihue 

Concurrent  graphics  library  subroutine 

mgrp 

Concurrent  graphics  library  subroutine 

Table  2.2.3.1-43:  Function  Summary  -  init_trail(  tank,  x_pos,  y_pos  ) 
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Table  2.2.3.1-44:  Function  Summary  -  zoom_icon() 

Zoom_icon  is  called  when  the  user  is  zooming  in  on  a  small  section  of  terrain.  The  screen 
is  rescaled  and  the  icon  segments  must  be  rec^culated  to  reflect  the  scaling.  Each  time 
zoom_icon  is  called,  a  new  scale  factor  must  be  determined.  A  ratio  of  the  starting  viewport 
coordinates  to  the  screen  coordinates  is  stored.  The  default  scale  factor  is  set  to 
DEFAIJLT_SCALE.  The  ratio  of  the  Y_coordinates  =  ratio  of  the  X_coordinates. 
Therefore,  the  ratio  of  the  y_coordinaies/DEFAULT_SCALE  yields  a  value  called 
Scale_ratio.  The  new  scale  ratio  must  always  be  <=  its  initial  value  in  order  for  the  icons 
and  their  orientation  to  be  recognizable.  Using  the  initial  scale_ratio  to  determine  the  new 
scale  factor  for  the  tank,  one  can  tell  if  the  ta^  can  be  drawn  using  its  actual  dimensions  or 
if  it  must  first  be  magnified.  A  new  set  of  segments  are  then  recalculated  relative  to  the 
zoom  window. 


Function 


calc  screen  scales 


calc  scale  factor 


create  symbolic  icons 


zoomed  in 


create  hi  se 


create  rwa  hi  seqs 


create  hull  seas 


create  turret  seas 


create  plane  seas 


create  smoke  se 


create  minefield  fla 


create  faad  turret  seas 


create  m2  hull  seas 


create  m2  turret  seas 


create  static  stripe  seas 


create  rwa  body  seas 


create  rwa  prop  seas 


create  stealth  seas 


create  bfit  seas 


create  bfit  stnpe  seas 


create  bfit  hi  seas 


create  all  burst  seas 


set  menu  icon  scale 


force  redraw  of  icons 


Calls 


Where  Described 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


Indir  fire.c 


Menu.c 


this  file 
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Table  2.2.3.1-45;  Function  Summary  -  top_IeveI_zoom_icon() 


Function 


calc  screen  scales 


calc  scale  factor 


create  symbolic  icons 


menu  symbolic 


calc  initial  icon  size 


create  hi  se 


create  rwa  hi  seas 


create  hull  seas 


create  turret  seas 


create  plane  seas 


create  smoke  se 


create  minefield  fla 


create  faad  turret  seas 


create  m2  hull  seas 


create  m2  turret  seas 


create  static  stnpe  seas 


create  rwa  body  seas 


create  rwa  prop  seas 


create  stealth  seas 


create  bfit  seas 


create  bfit  stripe  seas 


create  bfit  hi  seas 


create  all  burst  seas 


set  menu  icon  scale 


force  redraw  of  icons 


Calls 


Where  Described 


this  file 


this  file 


this  file 


Menu  func.c 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


Indir  fire.c 


Menu.c 


this  file 


Table  2.2.3.1-46:  Function  Summary  -  pre_zoom_icon() 


Function 


erase  all  bursts 


erase  all 


Calls 


Where  Described 


Indir  fire.c 


indir  fire.c 


Table  2.2.3.1-47:  Function  Summary  -  calc_scale_factor() 

This  function  determines  the  scale  factor  for  the  icons  in  a  xoom  environment.  If  the  scale 
factor  is  greater  than  1,  the  actual  dimensions  of  the  tank  are  used  (scale  =  1.0.) 
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Table  2.2.3.1-48:  Function  Summary  •  scaIe_icon(  scale_factor  ) 

When  called  by  the  menu,  this  routine  will  change  the  scale  factor  for  the  tank  icons  and 
recalculates  icon  coords. 


Parameter 


scale  factor 


Parameters 


Where  Tvoedef  Declared 


standard 


Function 


init  workino  cursor 


erase  all  tanks 


erase  all  bursts 


chanqe  icon  scalin 


create  hi  se 


create  rwa  hi  seqs 


create  hull  seqs 


create  turret  seqs 


create  olane  seqs 


create  smoke  se 


create  minefield  fla 


create  faad  turret  seqs 


create  m2  hull  seqs 


create  m2  turret  seqs 


create  static  stripe  seqs 


create  mva  body  seqs 


create  nwa  prop  seqs 


create  stealth  seqs 


create  bfit  seqs 


create  bfit  stripe  seqs 


create  bfit  hi  seqs 


create  all  burst  seqs 


force  redraw  of  icons 


show  icon  scale 


init  cursor 


Calls 


Where  Described 


Pvd  iface.c 


this  file 


Indir  fire.c 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


Indir  fire.c 


this  file 


Pvd  windows. c 


Pvd  iface.c 


Table  2.2.3.1-49:  Function  Summary  -  change_icon_scaIing(  scale  factor  ) 


Parameters 


Parameter 


scale  factor 


Where  Tvoedef  Declared 


standard 
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Table  2.2.3.1-50:  Function  Summary  -  calc_screen_scales() 

For  both  x  and  y  coordinates,  the  algorithm  is  the  same.  The  ratio  of  x_real  to  size  of 
viewport  in  x  direction  =  ratio  of  x_integer  to  size  of  viewport  in  x  direction  in  pixels. 
Similar  for  y.  Thus,  the  scale  factor  being  calculated  is  the  dimensions  of  the  integer 
window  /  dimensions  of  the  real  window  since  the  mathematical  calculations  are  using  the 
real  coordinates. 


Function 


maraetvcoor 


etvcoor 


lu^ 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.2.3.1-51:  Function  Summary  -  erase_all_tanks() 


Function 


erase  old  tank 


hiahliQht  icon 


moisvncrb 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


this  file 


this  file 


Concurrent  araohics  library  subroutine 


Function 


In 


maimode 


Table  2.2.3.1-52:  Function  Summary  -  erase_all_trails() 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.2.3.1-53:  Function  Summary  -  erase_whole_trail(  tank  ) 
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Table  2.2.3.1-54:  Function  Summary  -  force_redraw_of_icons() 

This  routine  causes  all  tanks  to  be  redrawn  on  the  screen.  It  is  used  when  a  zoom  or  scale 
change  has  occurred.  All  tanks  are  redrawn  immediately. 


Function 


In 


I  mode 


draw  tank 


hiQhliqht  icon 


mqisyncrb 


In 


Calls 


Where  Described 


Concurrent  araohics  library 


Concurrent  araohics  library 


Concurrent  araohics  library 


Concurrent  araohics  library 


this  file 


this  file 


Concurrent  araohics  library 


Concurrent  araohics  library 


subroutine 


subroutine 


subroutine 


subroutine 


subroutine 


subroutine 


Table  2.2.3.1-55:  Function  Summary  -  redraw_trail(  tank  ) 


Parameter 


tank 


Parameters 


reaister  ICONPTR 


Where  Typedef  Declared 


icon  dfn.h 


Calls  1 

Function 

Where  Described 

mqimode 

Concurrent  araohics  library  subroutine 

maihue 

Concurrent  qraphics  library  subroutine 

mqihue 

Concurrent  araohics  library  subroutine 

Concurrent  araohics  library  subroutine 


Table  2.2.3.1-56:  Function  Summary  -  get_icon_scale() 
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Table  2.2.3.1-57:  Function  Summary  -  calc_initial_icon_size() 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

FALSE 

int 

old  max  scale==max  scale 

TRUE 

int 

other 

I  Calls  I 

Function 

Where  Described 

maraetvcoor 

Concurrent  graphics  library  subroutine 

menu  50x 

Menu  func.c 

menu  lOOx 

Menu  func.c 

Table  2.2.3.1-58:  Function  Summary  • 

zoomed_in() 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

FALSE 

int 

old  max  scale==max  scale 

TRUE 

int 

other 

Table  2.2.3.1-59:  Function  Summary  -  set_symbolic_mode(  state  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

state 

int 

standard 

1  Calls  1 

Function 

Where  Described 

create  symbolic  icons 

this  file 

Table  2.2.3.1-60:  Function  Summary  -  create_symbolic_icons() 


1  Calls  1 

Function 

Where  Described 

init  working  cursor 

Pvd  if  ace.  c 

erase  all  tanks 

this  file 

erase  all  bursts 

Indir  fire.c 

change  icon  scaling 

this  file 

create  hi  seg 

this  file 

create  rwa  hi  segs 

this  file 

create  hull  segs 

this  file 

create  turret  segs 

this  file 

create  plane  segs 

this  file 

create  smoke  seg 

this  file 

create  minefield  flag 

this  file 

(Table  2.2.3.1-60  is  continued  on  the  foliowing  page.) 
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Function 

Where  Described 

create  faad  turret  segs 

this  fiie 

create  m2  hull  segs 

this  file 

create  m2  turret  segs 

this  file 

create  static  stripe  segs 

this  file 

create  rwa  body  segs 

this  file 

create  rwa  prop  segs 

this  file 

create  stealth  segs 

this  file 

create  bfit  segs 

this  file 

create  bfit  stripe  segs 

this  fiie 

create  bfit  hi  segs 

this  file 

create  ail  burst  segs 

indir  fire.c 

force  redraw  of  icons 

this  file 

show  icon  scale 

Pvd  windows.c 

init  cursor 

Pvd  iface.c 

Table  2.2.3.1-61:  Function  Summary  -  get_true_icon_scaIe() 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

symbolic  scale 

int 

symbolic  scale  mode 

scale 

int 

normal  scale  mode 

Table  2.2.3.1-62:  Function  Summary  •  icon_get_total_scale 

(  scale_x,  scale_y  ) 


Parameters 


Parameter 


inter  to  REAL 


Where  Tvpedef  Declared 


standard 


Table  2.2.3.1-63:  Function  Summary  -  draw_marker(  pkt  ) 
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Table  2.2.3.1-64:  Function  Summary  -  draw_lane(  pkt  ) 
This  function  shows  the  outline  of  the  breached  lane. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to 

BreachedLaneVariant 

p_sim.h 

Ca 

Is 

Function 

Where  Described 

Concurrent  oraphics  library  subroutine 

maiv 

Concurrent  graphics  library  subroutine 

mgimode 

Concurrent  graphics  library  subroutine 

mgihue 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

Table  2.2.3.1-65:  Function  Summary  -  draw_minefield(  pkt  ) 
This  function  shows  the  outline  of  the  minefield. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pkt 

pointer  to  MinefieldVariant 

p  data.h 

Ca 

Is 

Function 

Where  Described 

Concurrent  graphics  library  subroutine 

mgiv 

Concurrent  graphics  library  subroutine 

mgimode 

Concurrent  oraphics  library  subroutine 

mgihue 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

2. 2. 3. 2  detail.c 

This  CSU  includes  functions  for  describing  the  nearest  tank  and  displays  text  in  a  window. 
Informadon  may  be  included  on  tank  identifiers  (bumper  #,  vehicle  id  #);  general 
description  (tank,  IFV,  attack  vehicle);  status  (operational,  crippled,  destroyed ); 
appearance  (on  fire,  smoke  plume,  engine  smoke );  team  (A,  B  );  county  (US,  Soviet, 
unknown );  hdlures  (of  engine,  drive  train,  communications  and  electronics);  and 
capabilities  (ammo  supplier,  fuel  supplier,  recovery  or  repair  supplier.) 
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Table  2.2.3.2-1:  Function  Summary  -  detail_display(  world_state, 

vehicle_index  )  ~ 

This  function  provides  a  text  description  of  the  nearest  tank.  Text  is  displayed  in  a  window. 


Parameters 


Parameter 


world_state 


vehicle  index 


Function 


et  elevation 


ir 

k 


et  obiect  from  ouise 


decode  appearance 


decode  team 


decode  capabilities 


map  tank  index 


decode  ouises 


word  print 


et  utm 


knots  obiect 


pointer  to  WORLD_STATE 
struct 


inter  to  int 


Where  Typedef  Declared 


world_state.h 


standard 


Calls 


Where  Described 


Get  elev.c 


Text.c 


this  file 


this  file 


this  file 


this  file 


Text.c 


this  file 


this  file 


see  libtdb  in  MCC  CSCI 


Lase.c 


Table  2.2.3.2*2:  Function  Summary  -  word_print(  string,  window_width  ) 

This  function  prints  out  a  string  to  fit  a  narrow  window,  assuming  only  one  white  space 
character  between  words. 


Parameters 


Parameter 


strin 


window  width 


Where  Typedef  Declared 


standard 


standard 


Table  2.2.3.2-3:  Function  Summary  -  get_object_from_guise(  guise  ) 


Parameters 


e 


inter  to  VehicleGuises 


Return  Values 


Parameter 


uise 


Return  Value 


Where  Typedef  Declared 


basic.h 


lEnmnF 


uise  •  >distinquished 

ObjectTvpe 

value  of  Distinquished 

uise  -  >other 

ObiectTvpe 

other 
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Table  2.2.3.2-4:  Function  Summary  -  decode_guises(  guise,  model, 

country,  description  ) 


Parameter 


uise 


model 


count 


descnption 


Function 


et  vehicle  model 


et  vehicle  count 


et  vehicle  description 


Parameters 


e 


inter  to  VehicleGuises 


inter  to  char 


inter  to  char 


inter  to  char 


Where  Tvnedef  Declared 


basic.h 


standard 


standard 


standard 


Calls 


Where  Described 


this  file 


this  file 


this  file 


Table  2.2.3.2-5:  Function  Summary  -  get_vehicle_model(  vehicle  ) 

This  function  returns  a  pointer  to  a  static  string  representing  the  “model”  of  the  passed 
vehicle  object. 


Parameters 


Parameter 


vehicle 


Return  Value 


A-10 


AH-64 


OH-58D 


F-14D 


F-15E 


F-20 


F-4S 


F-5F 


M1 


M2 


M3 


M113 


M577 


M106 


M109 


M88 


M35 


M977 


M978 


LHD-1 


LHD-2 


DD-963 


ObiectTvpe 


Return  Values 


Where  Tvpedef  Declared 


sim.h 


Meanln 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


(Table  2  2.3.2-5  is  continued  on  the  following  page.) 
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Return  Value 


DD-964 


DD-976 


CG-47 


CG-52 


CVN-68 


CVN-69 


CVN-70 


BB-71 


BB-72 


BB-73 


BB-74 


PHM-1 


PHM-2 


CG-26 


CG-16 


CG-17 


CGN-38 


CGN-36 


CGN-37 


CGN-35 


CGN-25 


CGN-9 


CV-63 


CV-64 


CV-65 


CV-59 


CV-41 


CV-42 


CVN-65 


DDG-52 


DDG-993 


DDG-994 


DDG-2 


FF-1052 


FF-1040 


SSBN-726 


SSBN-727 


SSBN-728 


SSBN-640 


SSN-637 


SSN-585 


SSN-590 


SSN-688 


SSN-689 


SSN-753 


SS-580 


AD-41 


AD-42 
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Meanin 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


vehicle  US 


(Table  2.2.3.2-5  is  continued  on  the  following  page.) 
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Return  Value 


AFS-1 


Su-25 


MiG23 


MiG27 


Mi-24 


Mi-28 


M-1943 


T-72 


BREM1 


BMP-1 


BMP-1  K 


2S1 


BMP-2 


ZSU-23-4M 


GAZ-66 


Ural-375F 


Alpha 


unknown 


Function 


et  bfit  mode 
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Meanin 


vehicle  US 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


vehicle  USSR 


default 


Calls 


Where  Described 


Table  2.2.3.2*6:  Function  Summary  •  decode_appearance(  appearance, 

object  ) 

This  function  returns  a  pointer  that  is  effective  until  the  next  call  to  this  routine. 


Parameters 


Parameter 


appearance 


object 


Return  Value 


unsioned  Ion 


OblectTvoe 


Return  Values 


Where  Typedef  Declared 


standard 


sim.h 


Meanin 


value  of  MaxAppearance 


Table  2.2.3.2-7:  Function  Summary  -  decode_team(  force  ) 
This  function  returns  a  static  string  indicating  on  which  team  the  vehicle  is  playing. 


i  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

force 

int 

standard 
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Table  2.2.3.2-8:  Function  Summary  -  decode_capabiIities(  abilities  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

abilities 

VehicleCapabilities 

basic.h 

Table  2.2.3.2-9:  Function  Summary  -  get_vehicle_country(  vehicle  ) 

This  function  returns  a  static  string  indicating  the  country  of  manufacture  (or  design)  of  the 
vehicle. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vehicle 

ObiectTvpe 

D  sim.h 

1  Return  Values  I 

Return  Value 

Type 

Meanina 

US 

char 

vehicleCountry 

Soviet 

char 

vehcileCountrv 

unknown 

char 

default 
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Table  2.2.3.2-10:  Function  Summary  -  get_vehicIe_description 

(  vehicle*  short_desc  ) 

This  function  returns  a  pointer  to  a  static  string  that  provides  a  general  description  of  the 
type  of  vehicle  (tank,  IFV,  APC,  etc.  It  also  modifies  jhort_desc  to  point  to  as  “short”  no 
more  than  5-character  description. 


Parameter 


vehicle 


short  desc 


Parameters 


e 


ObiectTyoe 


inter  to  pointer  to  char 


Where  Tvpedef  Declared 


sim.h 


standard 


Return  Values 


lEin 


Return  Value 


Munition 


Structure 


Lite  form 


Unknown  domain! 


get_ground_vehicle_ 

description 


et  air  vehicle  description  char 


et  water  vehicle  description  char 


satellite  I  char 


unknown  object  char 


Meanln 


object  Domain 


object  Domain 


object  Domain 


obiectDomain 


vehicleEnvironment 


vehicleEnvironment 


vehicleEnvironment 


vehicleEnviornment 


default 


Calls 


et  ground  vehicle  description 

this  file 

et  air  vehicle  description 

this  file 

et  water  vehicle  description 

this  file 
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Table  2.2.3.2-11:  Function  Summary  -  get_ground_vehicle_description 

(vehicle,  short_desc  ) 


Parameter 


vehicle 


short  desc 


Parameters 


e 


ObiectTvoe 


inter  to  oointer  to  char 


Where  Tvoedef  Declared 


sim.h 


standard 


Return  Values 


Return  Value 


Tank 


Liaht  tank 


Armored  personnel  earner 


Command  post 


Howitzer 


Mortar 


Rocket  launcher 


Recon  vehicle 


Recovery  vehicle 


Supply  truck 


Tank  destroyer 


Air  defense  vehicle 


Ground  vehicle 


Meanin 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicie  Function 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


default 


Function 


et  bfit  mode 


Calls 


Where  Described 


Table  2.2.3.2-12:  Function  Summary  -  get  air_vehicle_description 

(vehicle,  short_desc  7  ~ 
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Table  2.2.3.2-13:  Function  Summary  -  get_water_vehicle_description 

(vehicle,  short  desc  )  ~ 


Parameter 


vehicle 


short  desc 


Parameters 


ObiectTvpe 


inter  to  pointer  to  char 


Where  Tvoedef  Declared 


sim.h 


standard 


Return  Values 


Return  Value 


Ammunition  supply  shi 


Amphibious  assault  shi 


Amphibious  caroo  shi 


Amphibious  command  shi 


Amphibious  transport  shi 


Attack  submarine 


Ballistic  missile  submarine 


Battleshi 


Aircraft  earner 


Combat  stores  shi 


Cruiser 


Destroyer  tender 


Destroyer 


Dock  landina  shi 


Fast  combat  su 


Fleet  oiler 


Friaate 


Hvrofoil 


Mine  countermeasures  shi 


Ocean  minesweeper 


Repair  shi 


Replenishment  shi 


Salvaoe  shi 


Submarine  tender 


Tank  landina  shi 


lEm 


Meanin 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


vehicleFunction 


default 


Function 


decode  damaae  cause 


decode  repair  cause 


set  text  window 


Calls 


Where  Described 


this  file 


this  file 


indir  fire.c 
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2.3  MAP  HANDLING  CSC  DESCRIPTION 

This  CSC  supports  a  color-coded  display  of  the  terrain  showing  various  geographic  details, 
such  as  roads,  rivers,  and  terrain  relief.  Shading  of  the  geographic  display  is  performed  by 
an  algorithm  which  assumes  a  sun  elevation  of  45  degrees  from  the  horizon  and  a  sun 
shining  from  the  top  right-hand  comer  of  the  display.  This  CSC  also  allows  a  user  to  vary 
map  features  of  zoom,  grid,  and  contour  lines. 

This  CSC  functionality  is  broken  down  into  lower-level  CSCs  shown  in  Figure  2-3. 


Figure  2*3:  Map  Handling  CSC  Structure. 
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2.3.1  Initial  Map  Handling  CSC  Description 
This  CSC  is  the  main  entry  for  Map  Handling. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.3.1- 1. 


Figure  2.3.1-1:  Map  Handling— Initial  Map  Handling  CSC  Structure. 


2.3. 1.1  ps_globals.c  CSU  Description  (/simnet/pvd/lib/paintlib.a) 

This  file  contains  globals  for  the  paint  system. 


2.3. 1.2  tdb_globals.c  CSU  Description  (/simnet/pvd/lib/paintlib.a) 
This  file  contains  globals  for  the  terrain  database. 


2.3. 1.3  write_string.c  CSU  Description  (/simnet/pvd/lib/paintlib.a) 

This  CSU  writes  a  string  to  the  screen  using  graphics  fonts,  on  particular  plan,  using  a 
particular  color. 
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Table  2.3.1.3-1:  -  Function  Summary  -  write  string(  window,  hues,  string, 

X,  y,  clear,  font  7 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

window 

int 

standard 

planes 

int 

standard 

hue 

int 

standard 

strinq 

pointer  to  char 

standard 

x.v 

int 

standard 

clear 

int 

standard 

font 

int 

standard 

Ca 

lls 

Function 

Where  Described 

mgiv 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

mgiclearpln 

Concurrent  graphics  library  subroutine 

mgihue 

Concurrent  graphics  library  subroutine 

2.3. 1.4  libtdb.a 

This  CSU  provides  access  to  the  terrain  database. 
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2.3.2  Continuous  Zoom  CSC  Description 

This  CSC  provides  the  continuous  zoom  optional  map  feature.  This  feature  supports 
arbitrary  scale  map  drawing. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.3.1- 1. 


Continuous 

Zoom 

3.3.2 


stripe.c 

3.3.2. 1 

new_2oom.c 

3.3.2.2 


Figure  2.3.1-1:  Map  Handling»Continuous  Zoom  CSC  Description. 
2.3.2. 1  stripe.c 

This  CSU  draws  a  horizontal  color  stripe,  starting  at  the  given  location  on  the  current 
window’s  coordinates. 


Table  2.3.2.1-1:  Function  Summary  -  display_stripe(  start_x,  start_y, 
box_edge,  initial_color,  color_increment,  num_boxes  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

start  X,  start  y 

int 

standard 

box  edge 

int 

standard 

initial  color 

int 

standard 

color  increment 

int 

standard 

num  boxes 

int 

standard 

1  Calls  1 

Function 

Where  Described 

moihue 

Concurrent  oraphics  library  subroutine 

mqibox 

Concurrent  oraphics  library  subroutine 
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2. 3. 2. 2  new_zoom.c 

This  CSU  provides  general  purpose,  arbitrary  scale  map  drawing. 

Note:  Function  names  beginning  with  mg  are  Concurrent  graphics  library  subroutines. 

Table  2.3.2.2-1:  new_zoom.c  Information 
This  file  defines  or  declares  these  global  variables. 


Global  Variables 


Typedef 

Source 


Abort  Cmd 


atch  indices 


External  Static  Variables 


dont_draw_overlays 


Stripe_Buffer 


Patch  Guards 


map  source 


map  destination 


no_map_on_paint 


BB  DESC 


BB  DESC 


int 


TDB  INFO 


Comments 


Declared  by:  init_paint_ 
system;  poly_zoom: 
unified _paint  square_ 
region;  pnav_paint_ 
region;  pnav_zoom_to_ 
scale;  paint_square_ 
region;  zoom_to_scale; 
pan;  setup_backjb; 
copy_map_back;  zoom_ 
out 


1  if  ''B  used  to  cancel 
command 


read  in  by  tdb  init  cache 


Comments 


if  no  overlays(roads 
Srivers)  are  to  be  drawn 
with  the  patches, because 
zoomed  too  far  out 


Get  set  to  segment  of 
cache  menwry  fill  with 
a  stripe  of  patches  from 
disk 


for  intervisibility,  etc 


For  CO 


For  CO 


For  set_map_on_paint()  & 
set_no_map_on_pai  nt ; 

If  1  paint_square_region 
will  NOT  draw  any  element 
of  the  map  (ground,  roads 
&  rivers,  features) 


declared  by 
init_terrain_db; 
terrain  description  field  of 
a  database  header. 
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Table  2.3.2.2-2:  Function  Summary  -  init_terrain_db(  database_file, 
cached_patches,  include_patch_guards  ) 

This  function  initializes  access  to  the  terrain  data  base.  Database_file  contains  the  pathname 
to  the  database.  Cached_patches  contains  the  number  of  patches  to  cache.  If  the  value  of 
include_patch _guards  is  1,  it  reads  in  patch  guards  for  intervisibility. 


Parameters 


Parameter 


database  file 


cached  patches 


include  patch  ouards 


Where  Tvpedef  Declared 


standard 


standard 


standard 


Return  Values 


Return  Value 


EH? 


Meanin 


unable  to  initialize  the  database 


function  successful 


Function 


tdb  init  cache 


tdb  error 


init  intervisibili 


Calls 


Where  Described 


see  libtdb  in  MCC  CSCI 


see  libtdb  in  MCC  CSCI 


Table  2.3.2.2-3:  Function  Summary  -  reinit_db(  db_name, 
include_patch_guards  ) 

This  function  switches  to  a  new  database.  Db_name  contains  the  name  of  the  new  database, 
such  as  “Graf’  or  “Knox.” 
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Calls  1 

Function 

Where  Described 

make  path  name 

init  env.c 

et  data  di  recto 


tdb  terminate 


init  terrain  db 


reset  views 


init  intervisibili 


init  contour 


clear  stored  bitmaps 


init  discrete  zoom 


init  env.c 


lib.tdb 


this  file 


Prev  view.c 


init  contour.c 


finite  zoom.c 


finite  zoom.c 


handle  input.c 


Table  2.3.2.2-4:  Function  Summary  -  init_paint_system  (map_window,  xO, 
yO,  width,  height,  min_map_scale,  pixels_per_inch,  colors, 
finite_zoom_options,  graphics_state  ) 

This  function  places  the  map  window  and  stores  global  variables  describing  it.  Map_ 
window  is  the  window  in  which  the  map  is  to  be  drawn.  xO  and  yO  define  the  lower  left 
comer  of  the  map  in  raw  pixel  coordinates.  Width  and  height  determine  the  size  of  the  map 
window.  l::min_map_sc^e  defines  the  greatest  zoom  allowed.  Pixels  per  inch  is  used  for 
the  graphics  system.  Colors  contains  various  planes  and  colors.  Finite_  zoom_options 
determines  what  to  draw  when  a  new  bitblt  is  created. 


Parameter 


map  window 


xO.  vO 


width,  height 


mm  map  scale 


ixels  per  inch 


colors 


finite_zoom_options 


Parameters 


e 


int 


int 


int 


float 


float 


inter  to  COLOR  SYSTEM 


pointer  to 

TERRAIN  FEATURES 


raphics  state 

|po 

inter  to  GRAPHICS 

rp 

Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


standard 


aint  svstem.h 


paint_system.h 


aint  svstem.h 


Function 


etiswdef 


moidefw 


w 


init  contour 


init  canopy  pattern 


Calls 


Where  Described 


Concurrent  Graphics  library  subroutine 


Concurrent  Graphics  library  subroutine 


Concurrent  Graphics  library  subroutine 


init  contour.c 


this  file 
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Table  2.3.2.2-5:  Function  Summary  -  poly_zoom(  xO,  yO,  xl,  yl  ) 

This  function  changes  the  current  map  zoom.  It  works  by  drawing  the  relevant  patch  of 
polygons.  It  uses  bit  zoom  instead  of  painting,  if  appropriate.  Input  coordinates  are  in 
meters  with  (0,0)  being  lower  left  comer.and  (1,1)  the  upper  right.  Assumes  input 
coordinates  form  a  square,  otherwise  forces  region  to  be  square. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

int  xO,  yO 

int 

standard 

int  x1 ,  v1 

int 

standard 

I  Calls  I 

Function 

Where  Described 

mqiv 

Concurrent  qraphics  library  subroutine 

mqimode 

Concurrent  qraphics  library  subroutine 

mqrrsi 

Concurrent  qraphics  library  subroutine 

force  square 

this  file 

zoom  to  scale 

this  tile 

unified  paint  square  reqion 

this  file 

Table  2.3.2.2-6:  Function  Summary  -  unified_paint_square_region(  xO_m, 

y0_m,  xl_m,  yl_m  ) 

This  function  checks  whether  there  is  a  shaded  discrete  zoom  for  this  map  scale.  It  rounds 
to  the  nearest  integer  in  the  scale  and  adjusts  comer  points. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

float  xO  m,  yO  m 

float 

standard 

float  xl  m.  y1  m 

float 

standard 

I  Return  Values  I 

Return  Value 

Type 

Meanlnq 

1 

int 

successful 

0 

int 

aborted 

Ca 

Is 

Function 

Where  Described 

qet  discrete  zoom  levels 

init  env.c 

mqiv 

Concurrent  qraphics  library  subroutine 

mqimode 

Concurrent  qraphics  library  subroutine 

bit  paint  square  reqion 

this  file 

paint  square  reqion 

this  file 

shade  desired 

Unshade.c 
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Table  2.3.2.2-7:  Function  Summary  -  pnav_paint_region(  xO_m,  yO_m, 

xl_m,  yl_m) 

This  function  uses  bit  zoom  instead  of  painting  if  appropriate.  Input  coordinates  are  in 
meters  with  (0,0)  being  the  lower  left  comer.  This  function  assumes  input  coordinates  form 
a  square. 


Parameters 


Parameter 


float  xO  m.  vO  m 


float  xl  m.  v1  m 


Where  Tvoedef  Declared 


standard 


standard 


Return  Values 


Return  Value 


1 


0 


Meanin 


successful 


aborted 


Function 


maiv 


moimode 


bit  paint  square 


amt  square 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


this  file 


this  file 


Table  2.3.2.2-8:  Function  Summary  -  pnav_zoom_to_scale(  scale,  x,  y  ) 

This  function  paints  a  map  in  the  given  scale  at  the  passed  map  center.  The  scale  of  the  map 
will  be  1  “scale,  with  x,y  being  the  center  of  the  map  in  meters.  The  scale  is  rounded  to  the 
nearest  integer. 
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Table  2.3.2.2-9;  Function  Summary  -  paint_square_region(  xO_m,  yO_m, 

xl_m,  yl_m  ) 

This  function  paints  a  square  sub-region  of  the  map.  Input  coordinates  are  in  meters  with 
(0,0)  being  the  lower  left  comer.  It  assumes  input  coordinates  form  a  square. 

This  function  also  converts  indices  into  screen  pixel  coordinates,  and  converts  new 
window  meters  into  GROUND_map  index,  and  scales  the  window  appropriately. 


This  function  computes  patches  involved.  Data  in  patch  file  is  stored  left  to  right,  bottom  to 
top. 

In  addition,  it  checks  whether  shade  is  desired. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

xO  m,  vO  m 

float 

standard 

x1  m,  v1  m 

float 

standard 

I  Return  Values  I 

Return  Value 

Meanlnq 

0 

int 

aborted 

1 

int 

successful 

1  Ca 

Is 

I  Function 

Where  Described 

Concurrent  qraphics  library  subroutine 

setup  back  fb 

FOR  DEBUGGING  ONLY 

mqiclearpln 

Concurrent  qraphics  library  subroutine 

mqrvcoor 

Concurrent  qraphics  library  subroutine 

mqihue 

Concurrent  qraphics  library  subroutine 

Concurrent  qraphics  library  subroutine 

mqrbox 

Concurrent  qraphics  library  subroutine 

mqisyncrb 

Concurrent  qraphics  library  subroutine 

tdb  cache  disable 

see  libtdb  in  MCC  CSCl 

copy  map  back 

this  file 

copy  nonmap  back 

this  file 

display  back  fb 

this  file 

draw  stripe 

this  file 

tdb  cache  enable 

see  libtdb  in  MCC  CSCl 

silent,  shade  on 

Unshade. c 

silent  shade  oft 

Unshade.c 

Overfayif.c 

t  zoom  icon 

Icon.c 

BBN  Systems  and  Technologies 


Plan  View  Display  CSCI 


Table  2.3.2.2-10:  Function  Summary  -  draw  polygons(  first_poly, 

end_of_polys,  vertex_Iist 

This  function  draws  the  polygons  from  first_poly  through  just  before  end_of_polys. 


Parameter 


firstjaoly 


end_of_polys 


vertex  list 


I  ESI!! 


Parameters 


e 


pointer  to 

POLYGON  DESCRIPTOR 


pointer  to 

POLYGON  DESCRIPTOR 


interto  TERRAIN  POINT  I  terrain.h 


Where  Tvoedef  Declared 


terrain.h 


terrain.h 


Function 


P  POLY  DUPLICATE 


GET  POLY  NUM  VERTS 


maisvncrb 


maihue 


GET  POLY  SHADING 


Calls 


Where  Described 


terrain.h 


terrain.h 


Concurrent  araohics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


terrain.h 


Table  2.3.2.2-11:  Function  Summary  -  draw_non_ground_polygons 
(first_poly,  end_of_polys,  vertM_list  ) 

This  function  draws  only  those  polygons  that  do  not  have  one  of  the  ground  hues 
(e.g.  roads  and  rivers). 


Parameter 


first_poly 


end_of_poly 


vertex  list 


Parameters 


e 


pointer  to 

POLYGON  DESCRIPTOR 


pointer  to 

POLYGON  DESCRIPTOR 


inter  to  TERRAIN  POINT 


Where  Tvpedef  Declared 


terrain.h 


terrain.h 


terrain.h 


_  1  1 

Calls 

Function 

Where  Described 

mqisyncrb 

Concurrent  araohics  library  subroutine 

GET  POLY  SHADING 

terrain.h 

maihue 

Concurrent  araohics  library  subroutine 

P  POLY  DUPLICATE 


MAX  FEATURE  VALUE 


GET  POLY  NUM  VERTS 


Concurrent  araohics  library  subroutine 


terrain.h 


aint  sys.h 


terrain.h 
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Table  2.3.2.2-12:  Function  Summary  -  draw_patch(  patch_offset  ) 

This  function  draws  the  immutable  terrain,  including  trees,  treelines,  and  canopies,  in  an 
entire  patch  of  Delta  terrain.  A  terrain  patch  is  is  m^e  up  of  a  number  of  polygons,  as 
defined  by  the  internal  variable,  num _polygons.  Patch_offset  is  the  number  of  a  patch, 
counting  from  0,  to  draw. 


Parameters 


Parameter 


atch  offset 


Where  Tvoedef  Declared 


standard 


Function 


draw  polvQons 


draw  non  around  polvaons 


GET  POLY  PRIORITY 


GET  POLY  SHADING 


GET  POLY  NUM  VERTS 


maihue 


marfc 


GET  CANOPY  POLY  NUM  VERTS 


rscalex 


El? 


mqisti 


draw  treeline 


maisvncrb 


shade  desired 


Calls 


Where  Described 


this  file 


this  file 


terrain.h 


terrain.h 


terrain.h 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


terrain.h 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


this  file 


Concurrent  araohics  library  subroutine 


Unshade.c 


Table  2.3.2.2-13:  Function  Summary  -draw_stripe(  p_left,  p_right,  row  ) 

This  function  draws  a  row  of  patches.  It  assumes  that  terrain  planes  have  been  cleared. 
Tdb_get_stripe  returns  a  pointer  to  a  char. 
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Table  2.3.2.2-14:  Function  Summary  •  zoom_to_scale(  scale,  marked_x, 

marked_y  ) 

This  function  zooms  map  display  to  scale  factor.  The  scale  factor  of  the  new  map  will  be 
1  :scale.  Maiked_x,  marked_y  defines  the  center  of  the  zoc»ned  region. 


Parameters 


Parameter 


scale 


Return  Value 


Where  Tynedef  Declared 


standard 


standard 


Return  Values 


Function 


moiv 


maimode 


maiunscalex 


unified  paint  sauare  reaion 


Meanin 


Coordinates  of  the  new  window 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


this  file 


Table  2.3.2.2-15:  Function  Summary  -  pan  (  marked_x,  marked_y  ) 

This  function  pans  the  display  by  repainting.  Panning  is  restricted  to  remaining  on  the 
map.  Marked_x,  marked_y  is  a  marked  point  which  determines  pan  direction  and  distance. 
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Table  2.3.2.2-16:  Function  Summary  -  zoom_out(  linear_factor  ) 

This  function  zooms  away  from  the  center  of  the  current  field  by  a  given  factor.  If  the  zoom 
out  exceeds  the  top  level,  the  top  level  map  is  displayed. 


Parameters 


Parameter 


linear  factor 


Where  Tvoedef  Declared 


standard 


Return  Values 


Return  Value 


1 


B73 


Meanln 


successful 


aborted 


Function 


moimode 


rrsi 


display  top  ma 


unified  paint  souare  reaion 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  oraphics  library  subroutine 


display  top.c 


this  file 


Table  2.3.2.2-17:  Function  Summary  -  setup_back_fb(clear_contour_plane) 


Parameter 


clear  contour  plane 


Parameters 


Where  Typedef  Declared 


standard 


Function 


etfb 


nriQifb 


moisyncrb 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.3.2.2-18:  Function  Summary  -  backout_of_change() 
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Table  2.3.2.2-19:  Function  Summary  •  dispiay_back_fb() 
This  function  sets  the  currently  displayed  frame  buffer  to  the  cuirent  back  buffer. 


Function 


etfb 


maifb 


etfb 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraohics  library  subroutine 


DEBUG  ONLY 


Table  2.3.2.2-20:Function  Summary  •  copy_map_back() 
This  function  copies  the  map  planes  and  map  area  to  the  back  frame  buffer. 


Function 


iv 


etfb 


moisyncrb 


maibblt2 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Table  2.3.2.2-21:  Function  Summary  -  copy_nonmap_back() 
This  function  copies  everything  not  on  the  map  planes  to  the  back  frame  buffer. 


Function 


lUl!ll!L 


etfb 


moifbfbex 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Table  2.3.2.2-22:  Function  Summary  -  print_bb_desc(  desc  ) 
This  function  prints  out  the  contents  of  a  bitblt  descriptor. 


Parameter 


desc 


Parameters 


inter  to  B8  DESC 


Where  Typedef  Declared 


efs.h 


lom 


Table  2.3.2.2-23:  Function  Summary  -  init_pixel_map_descriptors() 


Function 


moisyncrb 


moibboetview 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 
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Table  2.3.2.2-24:  Function  Summary  -  force_square(  xO,  yO,  xl,  yl  ) 
This  function  shrinks  the  upper  or  right  side  of  the  passed  rectangle  to  make  it  square. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

xO.  vO 

pointer  to  int 

standard 

xi.yi _ 

pointer  to  int 

standard 

1  Return  Values  1 

Return  Value 

Meaning 

1 

int 

resultant  square  has  0  area. 

0 

int 

square  has  area  other  than  0 

Table  2.3.2.2-25:  Function  Summary  -  init_canopy_pattern() 


1  Calls  1 

Function 

Where  Described 

mqiloadstippat 

Concurrent  graphics  library  subroutine 

mqiusestippat 

Concurrent  graphics  library  subroutine 

Table  2.3.2.2-26:  Function  Summary  -  set_no_map_on_paint() 

This  function  controls  the  assignment  of  setting  modes  for  repainting  the  map  when  the 
screen  is  redrawn. 


Table  2.3.2.2-27:  Function  Summary  •  draw_treeline(  current_treeline  ) 


This  function  draws  a  treeline,  given  a  pointer  to  a  treeline  header.  It  assumes  the  vertices 
for  the  treeline  immediately  follow  the  header.  The  drawing  context,  including  “hue” 
should  be  set  correctly  before  calling  this  routine. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

currentjreeline 

pointer  to 

TREELINE  HEADER 

terrain.h 

1  Calls  1 

Function 

Where  Described 

mqisyncrb 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 
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Table  2.3.2.2*28:  Function  Summary  -  highlight_altitude_hazard(  relative 

hazard  altitude  )  ~ 


Parameters 


Parameter 


relative  hazard  altitude 


ion 


Where  Tvpedef  Declared 


standard 


Return  Values 


Return  Value 


1 


1173 


Meanin 


successful 


aborted 


Function 


et  elevation 


rrsi 


m 


In 


moihue 


draw  X 


tdb  cache  enable 


draw  hazards  m  strioe 


Calls 


Where  Described 


Get  elev.c 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Intervis.c 


see  libtdb  in  MCC  CSCI 


this  file 


Table  2.3.2.2*29:  Function  Summary  *  draw_hazard_polygons(  first_poly, 
end_of_polys,  vertexjist,  hazard_altitude  ) 

This  function  draws  the  polygons  from  first_poly  through  just  before  end_of_polys. 


Parameter 


firstjxily 


end_of_polys 


vertex  list 


hazard  altitude 


Function 


P  POLY  DUPLICATE 


GET  POLY  NUM  VERTS 


moisvncrb 


rscalex 


llu? 


Where  Typedef  Declared 


terrain.h 


terrain.h 


terrain.h 


standard 


moisti 


Parameters 


e 


pointer  to 

POLYGON  DESCRIPTOR 


pointer  to 

POLYGON  DESCRIPTOR 


inter  to  TERRAIN  POINT 


float 


Calls 


Where  Described 


terrain.h 


terrain.h 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 
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Table  2.3.2.2>30:  Function  Summary  -  draw_hazards_in_patch 
(patch_offset,  hazard_altitude,  patch  ) 

This  function  draws  the  polygons  in  a  patch  of  terrain  that  have  a  vertex  exceeding 
hazard_altitude. 


Parameter 


atch  offset 


hazard  altitude 


atch 


iEn3 


Function 


rscalex 


maisvncrb 


draw  hazard 


Parameters 


Where  Tynedef  Declared 


standard 


standard 


standard 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  Graphics  library  subroutine 


Concurrent  araphics  library  subroutine 


this  file 


Table  2.3.2.2-31:  Function  Summary  -  draw  hazards_in_stripe 
(  p_left,  p_right,  row,  hazard_altnude  )  ~  ~ 

This  function  assumes  terrain  planes  have  been  cleared. 
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2.3.3  Finite  Zoom  CSC  Description 

This  CSC  provides  the  finite  zoom  optional  map  feature.  This  feature  supports  map 
drawing  at  fixed  scales  hrom  pre-computed  bitblt  (bit  block  transfer)  files. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.3.3-1. 
Additionally,  this  file  uses  the  file  new_zoom.c  (Section  2.3.2.2). 


Figure  2.3.3-1:  Map  Handling— Finite  Zoom  CSC  Structure. 


2.3.3. 1  finite_zoom.c 

This  file  contains  routines  that  implement  rapid  drawing  of  the  map  with  pre-computed 
bitmaps. 

Some  Abbreviations: 

'bit-block  transfer;  'bitblt' =block  transfer,  bitwise;  'fb'=frame  buffer,  'lru'=least  recently 
used. 

Performance  notes  and  tradeoffs: 

In  blt_paint_square_region,  there  is  no  significant  speed  up  by  biting  to  only  the  back 
frame  buffer  (-^sec)  instead  of  to  both  (~7sec)! 

Performance  with  various  numbers  of  screens  in  a  bitmap:  (4  MBy  memory) 


- 1  screens  per  bitmap: 

1  panel: 

2.4  sec 

2  panels: 

4  sec 

4  panels: 

7  sec 

-  4  screens  per  bitmap: 

1  panel: 

6  sec 

2  panels: 

13  sec 

4  panels: 

20  sec 

Why  is  the  4  screen  per  bitmap  case  so  much  slower?  A  likely  explanation: 

A  significant  time  is  taken  to  read  in  the  bitmap  from  the  file  -  and  each  bitmap  is  4x  larger 
in  this  case.  Note  that  the  times  for  4  panels  (1  screen/bmap)  and  1  panel 
(4  screens/bmap)  are  nearly  identical. 


This  file  defines  or  declares  these  global  variables: 
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Global  Variables 


Typedet 

Source 


This  file  defines  these  external  static  variables. 


External  Static  Variables 

current_zoom 

int 

num_bitmaps 

int 

stored  bitmaps 
t  MAX_BITMAPS_STORED  ] 

array  of  structs 
of  type 

BITMAP 

CACHE 

file_header 

struct  of  type 
FILE 

HEADER 

map_window 

BB_DESC 

World_Meters_Per_Pixel 

float 

use_counter 

int 

Typedef 

Source 


Comments 


explicitly  declared  in  these 
functions: 

•init_discrete_zoom 

•createjile 

•create_bitmap 

•blt_painl_square_ 


Comments 


Reciprocal  of  scale  factor 
for  current  bitmap;  0 
means  no  resident  bitma 


Number  of  bitmaps  in 
memory  at  current  zoom 


Sorted  on  y,  then  x 


descriptor  for  the  visible 
map  on  the  screen 


meters  on  map 
represented  by  one  pixel 


Numbers  the  bitmaps  as 
they  are  used,  for  finding 
LRUed 


Table  2.3.3.1-1:  Function  Summary:  init_discrete_zoom() 

This  function  is  called  once  when  the  plan  view  starts  up.  This  function  creates  the  bitmaps 
needed  and  initializes  the  list  of  supported  bitm^s. 
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Table  2.3.3.1-2:  Function  Summary:  clear_stored_bitmaps() 
This  function  resets  the  finite_zoom  software  nxxiule,  clearing  all  stored  bitmaps. 


Function 


mqibbfree 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Table  2.3.3.1-3:  Function  Summary:  init_stored_bitmaps(  map_fd,  scale  ) 

This  function  reads  the  file  header  and  stores  this  information  in  external  statics.  It  returns  1 
if  successful,  0  otherwise.  Scale  is  the  reciprocal  of  map_scale.  Map_fd  is  the  file 
descriptor  of  the  file  containing  bitmaps  of  interest. 


Parameters 


Parameter 


scale 


mao  fd 


Where  Tvpedef  Declared 


standard 


standard 


Return  Value 


1 


En3 


Return  Values 


Meanin 


file  I/O  failed 


function  successful 


1  Errors 

Error 

Reason  for  Error 

init  stored  bitmaps /Iseek 

system  messaoe 

init  stored  bitmaps /read 

system  messaoe 

Table  2.3.3.1-4:  Function  Summary:  create_file(scaie,  map_file) 

This  function  returns  the  file  descriptor  of  a  newly  created  bitmap  file  in  the  following 
format: 

*int  bitmaps  =  num_x  *  num_y 

int  num_x  bit  maps  in  x  direction 

int  num_y  bit  maps  in  y  direction 

float  x_spacing  edge  length  of  bitmap  in  meters  (less  in  last  bitmaps) 
float  y_spacing 

int  index[  bitmaps  ];  where  to  Iseek  to  find  bmap  desc. 

BB_DESC  desc  \  Repeated  bitmaps  times  char[]  bb_data  / 

Scale  is  the  reciprocal  of  the  scale  of  the  map  to  create.  Map_file  is  the  name  of  the  file  to 
create. 


_  Parameters 


Parameter  I  Type  ]  Where  Typedef  Declared 


scale  int 


map  file 


inter  to  char 


standard 


standard 
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Return  Values 


Return  Value 


mapjd 


internal  integer 


Meanln 


returns  file  descnptor  of  newly 
created  bitmap  file 


indicates  I/O  failure 


Error 


create  file/ooen 


create  file/wnte 


Errors 


Reason  for  Error 


system  message 


system  message 


Function 


mgiv 


set  no  map  on  paint 


set  map  on  paint 


mgibbfree 


file  bitma 


Calls 


Where  Described 


Concurrent  graphics  library  subroutine 


new  zoom.c 


new  zoom.c 


Concurrent  graphics  library  subroutine 


this  file 


Table  2.3.3.1-5:  Function  Summary:  create_bitmap() 

This  function  creates  a  host  bitmap  for  discrete  zooming.  Since  the  graphics  library  can 
only  draw  to  screen  memory,  the  host  bitmap  image  is  constructed  out  of  a  series  of  screen 
images  that  are  bit  blted  into  host  memory. 

This  function  sets  up  new  contour  and  grid  state;  allocates  memory  for  bitmap;  sets  the 
bitmap  frame  buffer  to  the  currently  displayed  frame  buffer;  loops  over  all  screens,  painting 
the  map  to  the  display  screen  (with  grid  or  contours  if  requested)  and  then  biting  it  from  the 
display  screen  memory  to  the  bitmap  in  host  memory;  sets  contour  spacing;  and  restores 
Contour  and  Grid  State. 


Return  Value 


bitma 


Return  Values 


see  Global  Variables 


Meanln 


returns  bitma 


Function 


et  grid  spacin 


et  contour  interval 


mgibbdesci 


ibballoc 


count  bits  set 


amt  sguare  region 


isvncrb 


ibblt2 


Calls 


Where  Described 


Gnd.c 


init  contour.c 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


this  file 


new  zoom.c 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 
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Table  2.3.3.1-6:Function  Summary:  nie_bitmap(  fd,  bitmap,  x_index, 

y_index,  indexjocation  ) 

This  function  passes  file  index  and  file  pointer.  Fd  is  the  file  descriptor  of  the  file  to  write 
to.  This  file  is  assumed  to  be  open  and  correctly  positioned.  Bitmap  refers  to  the  bitmap  to 
be  written  to  the  file.  x_index  and  y_index  are  the  indices  of  the  bitmaps  in  the  file. 
Index_location  is  updated  as  a  side  effect  of  this  function. 


Parameters 


Parameter 


fd 


bitma 


X  index 


'  index 


index  location 


int. 


BB  DESC 


int. 


int 


inter  to 


irs 


Where  Tvoedef  Declared 


standard 


efs.h 


standard 


standard 


standard 


Return  Values 


Return  Value 


Error 


file  bitmaD/wnte(#l 


file  bitmaD/write(#2 


file  bitmap/writef#3 


file  bitmap/lseek(#2 


file  bitmap/lseek 


Errors 


Reason  for  Error 


system  messaoe 


system  messaoe 


system  messaoe 


system  messaoe 


system  messaoe 


Table  2.3.3.1-7:  Function  Summary  -  count_bits_set(  long  word  ) 
This  function  counts  the  number  of  bits  set  in  the  passed  integer. 


Parameters 


Parameter 


lono  word 


Return  Value 


count 


internal  integer 


Where  Typedef  Declared 


standard 


Meanin 


number  of  bits  in  long  word  that 
were  ‘1’ 


Table  2.3.3.1-8:  Function  Summary  -  get_shift(  long  word  ) 

Returns  the  number  of  least  significant  bits  of  0  in  the  passed  32-bit  word.  Returns  32  if 
there  are  no  Is  in  the  long_word. 
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Return  Values 


Return  Value 


32 


Meanin 


32  means  there  were  no  Is  in 
Iona  word 


number  of  least  significant  bits 
of  0  in  the  passed  32-bit  word. 


Table  2.3.3.1-9:  Function  Summary  -  blt_paint_square_region  (xO_m, 

yO_m,  xl_m,  yl_m) 

This  function  paints  a  section  of  the  map  into  the  map  window  using  presaved  bitmaps.The 
section  of  the  map  to  be  painted  is  specked  as  a  lower  left  and  upper  right  comer  in  world 
coordinates  (real  world  meters  measured  from  the  lower  left  comer)  of  the  database.  If  the 
current  bitmap  frle  is  at  the  requested  scale,  the  appropropriate  section  of  the  map  is  blt'ed 
to  the  screen.  If  not,  an  attempt  is  made  to  open  an  existing  bitm^  file  at  the  requested 
scale,  and  if  this  is  successful,  drawing  proceeds  as  before.  Otherwise,  a  bitmap  file  is 
created  at  the  requested  scale.  (This  is  a  very  slow  process,  involving  drawing  the  entire 
database  at  the  requested  scale,  one  screen  at  a  time).  If  even  this  fails,  the  requested  map 
is  painted  directly  from  the  database,  using  paint_square_region. 


Parameters 


Parameter 


xO  m,  vO  m 


xl  m.  v1  m 


Where  Tvpedef  Declared 


standard 


standard 


1  Calls  1 

Function 

Where  Described 

clear  stored  bitmaps 

this  file 

make  path  name 

Init  env.c 

amt  square  reaion 


init  stored  bitmaps 


rrsi 


setup  back  fb 


maiclearpln 


etfb 


morvcoor 


In 


maihue 


marbox 


display  bitma 


maisvncrb 


zoom  icon 


display  back  fb 


map  back 


et  db  directo 


new  zoom.c 


this  file 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


New  zoom.c 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


this  file 


Concurrent  graphics  library  subroutine 


Overlayif.c 


Icon.c 


New  zoom.c 


New  zoom.c 


Init  env.c 
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Table  2.3.3.1-10: 


Function  Summary  •  display  bitmap(map_fd,  x_index, 
yjndex,  start_x,  start_:^ 


This  function  first  checks  to  see  whether  bitm^  is  in  memory.  If  not,  the  bitmap  is  loaded; 
if  not,  it  performs  a  bitblt  into  the  appropriate  location.  Map_fd  is  the  file  pointer  to  the 
necessary  bitmap  file.  Start_x,  start_y  defines  where  the  lower  left  comer  of  the  bitmap 
should  be,  in  screen  coordinates. 


Parameters 


Parameter 


map  fd 


start  X.  start 


Where  Tvoedef  Declared 


standard 


standard 


standard 


Function 


moibbtree 


mQibblt2 


moisvncrb 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.3.3.1-11:  Function  Summary  -  get_bitmap(  map_fd,  x_index, 

y_index  ) 

This  function  returns  a  pointer  to  a  bitmap  descriptor  containing  the  bitmap  with  bitmap 
coordinates  (x_index,  yjndex)  in  the  file,  map_fd.  A  cache  is  used  to  minimize  file 
access.  Map_fd  refers  to  the  file  containing  bitmaps  for  the  current  zoom. 

This  function  fills  an  empty  cache  slot  It  replaces  the  least  recently  used  bitmap  in  the 
cache,  first  freeing  old  memory. 
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Table  2.3.3.1-12:  Function  Summary 
This  function  gets  the  least  recently  used  cache  entry. 


get_lru_bitmap() 


1  Return  Values  1 

Return  Value 

Meaning 

least_used 

internal  integer 

array  index  at  Iru  bitmap  in 

stored  bitmaps 

Table  2.3.3.1-13:  Function  Summary  -  readin_bitmap 
(  map_fd,  x_index,  y_index,  bb_desc  ) 

This  function  reads  in  the  bitmap  with  bitmap  coordinates  (xjndex,  y_index)  in  file 
map_fd,  into  the  passed  bitmap  descriptor. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

map  fd 

int 

standard 

int 

standard 

1  bb  desc 

BB  DESC* 

libopdefs.h 

Ca 

Is 

Function 

Where  Described 

mgibballoc 

Concurrent  oraphics  library  subroutine 

mqibbsize 

Concurrent  oraphics  library  subroutine 

BBN  Systems  and  Technologies 


Plan  View  Display  CSCI 


2.3.4  Save/Recall  Zoom  CSC  Description 

This  CSC  enables  a  zoom  optional  map  feature  to  be  saved  and  recalled. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.3.4- 1. 


Save/ 

Recall 

Zoom 

3.3.4 


save_ 
array.c 
3.3.4. 1 

save_ 

screen.c 

3.3.42 

save_ 

zoom.c 

3.3.4.3 

display_ 

file.c 

3.3.44 

display_ 

top.c 

3.3.4.5 


Figure  2.3.4-1:  Map  Handling—Save/Recall  Zoom  CSC  Structure. 
2.3.4. 1  save_array.c 

This  CSU  manages  the  storage  and  recall  of  an  array  to  and  from  a  file. 
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Table  2.3.4.1-1:  Function  Summary  •  save_array(  array,  length,  file_name) 

This  function  saves  an  array  to  a  file.  The  file  is  headed  by  a  longword  which  is  the  length 
of  the  array  in  bytes. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

array 

pointer  to  int 

standard 

lenath 

int 

standard 

file  name 

pointer  to  char 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

1 

int 

successful 

-1 

int 

error  creatina  file 

-2 

int 

error  in  writina  file 

Table  2.3.4.1-2:  Function  Summary  -  recall_array(  array,  length, 

rile_name) 

This  function  recalls  an  array  from  a  file  created  by  store_array(...) .  The  file  is  a  binary 
dump  of  the  array  preceeded  with  a  longword  header  giving  the  array  length  in  bytes.  The 
array  ia  calloc’ed  from  heap  storage  on  a  longword  boundary. 


I  Parameters  j 

Parameter 

Where  Typedef  Declared 

array 

pointer  to  pointer  to  int 

standard 

length 

pointer  to  int 

standard 

file  name 

pointer  to  char 

standard 

I  Return  Values  I 

Return  Value 

Meaning 

1 

int 

successful 

-1 

int 

unable  to  open  file 

-2 

int 

unable  to  read  from  file 

-3 

int 

unable  to  allocate  memory 

2. 3. 4. 2  save_screen.c 

This  CSU  saves  a  specified  rectangular  region  of  the  screen  to  a  file. 
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Table  2.3.4.2-1:  Function  Summary  -  save_screen(  xO,  yO,  xl,  yl, 

plane_mask,  nie_name  ) 

This  function  saves  a  specified  rectangular  region  of  the  screen  to  a  file.  Only  the  specified 
planes  are  saved.  Pass^  coordinates  are  in  window  0  (raw  screen)  coordinates. 


ParamMer 


xO,  yO 


x1.y1 


plane  mask 


file  name 


Return  Value 


-1 


Function 


mgiv 


mqigetfb 


mgigetfbdata 


Parameters 


Type 


int 


int 


int 


pointer  to  char 


Where  Typedef  Declared 


standard 


standard 


standard 


standard 


Return  Values 


Type 


int 


mt 


int 


Meaning 


error  occurred  in  create 


error  occurred  in  write 


successful 


Calls 


Where  Described 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


2. 3. 4. 3  save_zoom.c 

This  CSU  saves  the  current  terrain  map  to  a  file. 


Table  2.3.4.3-1;  Function  Summary  -  save_zoom() 


This  function  saves  the  current  terrain  map  to  a  file. 


Ca 

Is 

Function 

Where  Described 

mgiv 

Concurrent  graphics  library  subroutine 

get  db  directory 

Init  env.c 

save  screen 

this  file 

Concurrent  graphics  library  subroutine 
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Table  2.3.4.3-2:  Function  Summary  >  recall_zoom() 


Function 


et  db  directo 


IV 


rvcoor 


setuD  back  fb 


backout  of  chanoe 


disDiav  back  fb 


’  mao  back 


Calls 


Where  Described 


Init  env.c 


Concurrent  qraohics  library  subroutine 


Concurrent  Qraohics  Kbrary  subroutine 


New  zoom.c 


New  zoom.c 


New  zoom.c 


New  zoom.c 


2. 3. 4. 4  display_file.c 

This  CSU  displays  the  contents  of  a  file  created  by  save_screen.c. 


Table  2.3.4.4-1:  Function  Summary  •  display_file(  nie_name  ) 

This  function  displays  the  contents  of  a  file  created  by  save_screen.c.  The  file’s  contents 
are  written  to  the  cuirently  displayed  frame  buffer. 
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2. 3. 4. 5  display_top.c 

This  CSU  draws  the  largest  scale  map. 


Table  2.3.4.5>1:  Function  Summary  -  display_top_map() 
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2.3.5  Contours  CSC  Description 

This  CSC  provides  the  optional  contour  lines  map  feature  and  supports  interval  setting 
between  contour  lines. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.3.5- 1. 


Contours 

3.3.5 


gen_ 

contour.c 

3.3.5. 1 

draw_ 

contour.c 

3.3.5.2 

delt_ 

contour.c 

3.3.5.3 

init_ 

contour.c 

3.3.5.4 

low_ 

contour.c 

3.3.5.5 


Figure  2.3.5- 1:  Map  Handling— Contours  CSC  Structure. 

2.3.5. 1  gen_contour.c 

This  CSU  clears  the  contour  from  both  frame  buffers. 
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Table  2.3.5.1-1:  Function  Summary  -  clear_contour() 
This  function  clears  the  contour  from  both  frame  buffers. 


Cal 

Is 

Function 

Where  Described 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

maihue 

Concurrent  araphics  library  subroutine 

maibox 

Concurrent  araphics  library  subroutine 

2. 3. 5. 2  draw_contour.c 

This  CSU  draws  contours  in  the  map  window  based  on  current  contour  levels  and  zoom. 


Table  2.3.5.2-1:  Function  Summary  -  draw_contour() 

This  function  draws  contours  in  the  MAP_WINDOW  based  on  current  contour  levels  and 
zoom. 


1  Return  Values  1 

Return  Value 

Meanina 

0 

int 

contours  were  aborted 

1 

int 

successful 

I  Calls  I 

Function 

Where  Described 

return  delta  contour 

Table  2.3.5.2-2:  Function  Summary  -  draw_top_contours() 


This  function  draws  the  contours  for  the  top  level  map. 


I  Calls  I 

Function 

Where  Described 

make  path  name 

Init  env.c 

aet  db  directory 

Init  env.c 

draw  contour 

this  file 

save  screen 

Save  screen. c 
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Table  2.3.5.2-3:  Function  Summary  -  add_contours(  grid_present  ) 
This  function  adds  contours  at  the  appropriate  spacing  to  the  screen. 


Parameters 


Parameter 


rid  present 


Function 


top  level 


draw  top  contours 


draw  contour 


draw  arid  lines 


Where  Tvnedef  Declared 


standard 


Calls 


Where  Described 


this  file 


this  file 


this  file 


Grid.c 


Table  2.3.S.2-4:  Function  Summary  -  top_level() 


Return  Values 


Return  Value 


Meanin 


at  top  level  of  map  displa 


at  other  than  top  level 


Function 


rrsi 


Calls 


Where  Described 


Concurrent  qraphics  libra 


2. 3. 5. 3  delt_contour.c  CSU  Description  (/simnet/pvd/lib/paintlib.a) 

This  CSU  contours  the  entire  screen  from  global  memory.  Contour  map  is  drawn  on 
contour_plane.  It  draws  contours  for  an  individual  Delta  graphics  patch. 

Table  2.3.5.3-1:  Function  Summary  •  delta_contour(  contour_plane  ) 

This  function  contours  the  entire  screen  from  global  memory.  Contour  map  is  drawn  on 
contour_plane. 
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Calls  1 

Function 

Where  Described 

moimode 

Concurrent  oraphics  library  subroutine 

In 


maihue 


mqisvncrb 


nrsi 


tdb  cache  disable 


tdb  cache  enable 


draw  contour  stri 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


see  iibtdb  in  MCC  CSCI 


see  Iibtdb  in  MCC  CSCI 


this  file 


Table  2.3.5.3-2:  Function  Summary  •  draw_contour_stripe 

(  left,  right,  row) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

left 

int 

standard 

int 

standard 

1  row 

int 

standard 

i  Calls  1 

Function 

Where  Described 

contour  patch 

this  file 

Table  2.3.5.3-3:  Function  Summary  -  contour_patch(  patchjndex  ) 
This  function  draws  contours  for  an  individual  delta  graphics  patch. 


Parameters 


Parameter 


atch  index 


Where  Typedef  Declared 


standard 


Function 


GET  POLY  NUM  VERTS 


GET  POLY  PRIORITY 


contour  pol 


moihue 


draw  delta 


Calls 


Where  Described 


terrain.h 


terrain.h 


Low  contour.c 


Concurrent  oraphics  library  subroutine 


Low  contour.c 
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2. 3. 5. 4  init_contour.c  CSU  Description  (/simnet/pvd/Iib/paintlib.a) 

This  CSU  sets  the  initial  contour  levels.  It  reads  elevation  limits  and  sets  contour  intervals. 


Table  2.3.5.4-1:  Function  Summary  -  init_contour() 


This  function  sets  the  initial  contour  levels. 


1  Calls  1 

Function 

Where  Described 

read  elevation  limits 

this  file 

set  contour  interval 

this  file 

Table  2.3.5.4-2:  Function  Summary  -  new_contourJntervaI(  interval  ) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

interval 

int 

standard 

1  Calls  1 

Function 

Where  Described 

set  contour  interval 

this  file 

Table  2.3.5.4-3;  Function  Summary  -  set  contour_interval(  start_z, 

spacing,  num_z  7  ” 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

start  z 

float 

standard 

spacino 

float 

standard 

num  z 

int 

standard 

Table  2.3.5.4-4:  Function  Summary  -  read 

_elevation_limits 

1  Return  Values  I 

Return  Value 

Meanina 

1 

int 

successful 

0 

int 

otherwise 

Table  2.3.5.4-5:  Function  Summary  -  get_contour_interval() 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

Map.contourjevels.  heights!  1  ] 
-Map.contour  levels. heightsfOl 

float 

calculation  of  interval  between 
contour  lines  in  meters 
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This  CSU  contours  an  individual  Delta  graphics  polygon  and  encodes  threshold  patterns. 

Table  2.3.5.5-1:  Function  Summary  -  contour_poly(  num_vertex,  vertex, 
vertexjist,  z_levels,  num_z_levels  ) 

This  function  contours  an  individual  Delta  graphics  polygon.  The  polygon  is  assumed  to  be 
convex,  coplaner  and  3  or  4  sided. 


Parameter 


num  vertex 


vertex 


vertex  list 


z  levels 


num  z  levels 


Parameters 


e 


ini 


unslaned  short 


inter  to  TERRAIN  POINT 


float 


int 


Where  Tvoedel  Declared 


standard 


standard 


terrain.h 


standard 


standard 


Function 


encode  contour 


isyncrb 


Calls 


Where  Described 


this  file 


Concurrent  qraphics  library  subroutine 


Concurrent  oraphlcs  librar/  subroutine 


Table  2.3.5.5-2:  Function  Summary  •  encode_contour(  threshold,  poly, 
num  points,  vertex  iist,  edge  l,  edge_2  ) 

This  function  computes  the  index  of  the  starting  points  of  the  2  edges  that  the  contour 
intersects. 
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Table  2.3.5.5'3:  Function  Summary  -  draw  delta_poly 
(  num_vertex,  vertex,  vertex_list  T 

This  function  erases  an  individual  Delta  graphics  polygon. 


Parameters 


Parameter 


num  vertex 


vertex 


vertex  list 


Function 


int 


unsianed  char 


Where  Tvoedef  Declared 


standard 


standard 


inter  to  TERRAIN  POINT  I  terrain.h 


Calls 


Where  Described 


Concurrent  oraphics  libra 
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2.3.6  Grid  CSC  Description 

This  CSC  provides  the  optional  UTM  grid  lines  map  feature  and  supports  interval  setting 
between  grid  lines. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figme  2.3.6-1. 

Grid 

3.3.6 


grkJ.c 
3.3.6. 1 


Figure  2.3.6-1:  Map  Handling— Grid  CSC  Structure. 

2.3.6. 1  grid.c  CSU  Description  (/simnet/pvd/lib/paintlib.a) 

This  CSU  provides  functions  for  overlaying  UTM  (universal  terrain  meridian)  grid  lines. 
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Table  2.3.6.1-1:  Function  Summary  -  draw_horiz_grid_lines 

(  rxl,  ryb,  rxr,  ryt  ) 


Parameters 


Parameter 


rxl 


Function 


et  utm 


calc  first  position 


moihue 


maibox 


maisvncrb 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Calls 


Where  Described 


see  libtdb  in  MCC  CSCI 


this  file 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.3.6.1-2:  Function  Summary  -  draw_vert_grid_Iines 

(  rxl,  ryb,  rxr,  ryt  ) 
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Table  2.3.6.1-3:  Function  Summary  -  draw_grid_lines() 


Function 


mqimode 


nrsi 


IV 


In 


maihue 


maidash 


draw  vert  arid  lines 


draw  horiz  and  lines 


Calls 


Where  Described 


Concurrent  araohics  librarv 


Concurrent  araohics  hbrary 


Concurrent  araohics  library 


Concurrent  araohics  library 


Concurrent  araohics  library 


Concurrent  araohics  library 


this  file 


this  file 


subroutine 


subroutine 


subroutine 


subroutine 


subroutine 


subroutine 


Table  2.3.6.1-4:  Function  Summary  •  calc_first_position(  bound  ) 

When  grid  lines  are  drawn,  the  lines  must  always  appear  at  the  same  map  meter  points  as 
they  would  on  a  full-scale  map.  Therefore,  the  x  or  y  coordinate  of  the  first  line  must  be 
determined  based  on  the  current  viewport  coordinates.  This  is  done  by  taking  the  lower  x 
or  y  bound,  dividing  by  the  grid_spacing,  adding  1  (to  round  up)  and  multiplying  again  by 
the  grid_spacing. 


Parameter 


bound 


Return  Value 


Start_loc  +  (MAX_SPACING 
start  loc) 


start  loc 


!(val%MAX  SPACING 


Parameters 


Return  Values 


e 


static  int 


static  int 


static  int 


Where  Typedef  Declared 


standard 


Meanin 


algorithm  for  calculating  first 
position  for  arid  spacina 


bound  /  arid  spacinq  +  1 


value  of  MAX  SPACING 


Table  2.3.6.1-5:  Function  Summary  -  change_grid_spacing(  new  val  ) 


Parameters 


Parameter 


new  val 


Where  Typedef  Declared 


standard 


Table  2.3.6.1-6:  Function  Summary  -  get_grid_spacing() 
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2.3.7  Other  Features  CSC  Description 

This  CSC  provides  other  map  features,  such  as  terrain  shade  and  color.  It  also  accesses  a 
previous  map  view. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.3.7-1. 


Other 

Features 

3.3.7 


unshade.c 
3.3.7. 1 

switch_ 

db.c 

3.37.2 

prev_ 

view.c 


3.3.7.3 


objects.c 

3.37.4 


Figure  2.3.7-1:  PVD-Level— Initial  PVD-Level  CSC  Structure. 


2. 3. 7.1  unshade.c 

This  CSU  turns  map  shading  on  or  off. 


Table  2.3.7.1-1:  Function  Summary  -  shade_desired() 


1  Return  Values  I 

Return  Value 

Meanina 

shade 

static  int 

returns  shade 
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Table  2.3.7.1-2:  Function  Summary  •  toggle_shade() 


1  Calls  1 

Function 

Where  Described 

shading  menu 

entry  off 

Edit  menu.c 

shading  menu 

entry  on 

Edit  menu.c 

handle  repaint 

handle  input.c 

Table  2.3.7.1-3:  Function  Summary  -  silent_shade_off() 
This  function  assigns  map  shading  off. 

Table  2.3.7.1-4:  Function  Summary  -  silent_shade_on() 

This  function  assigns  map  shading  on. 


2. 3. 7. 2  switch_db.c 

This  CSU  switches  databases. 


Table  2.3.7.2-1:  Function  Summary  -  switch_database(  entry_^num  ) 


1  Parameters  1 

I  Parameter 

Type 

Where  Tvpedef  Declared 

int 

standard 

Ca 

Is 

Function 

Where  Described 

get  db  names 

Init  env.c 

check  mark 

Menu  fea.c 

reinit  db 

New  zoom.c 

2. 3. 7. 3  prev_view.c 

This  CSU  displays  previous  and  next  map  views;  manages  storage  of  views  in  buffers. 


Table  2.3.7.3-1:  Function  Summary  -  previous_view() 
This  function  displays  the  previous  map  view. 


1  Return  Values  i 

Return  Value 

Type 

Meaning 

0 

int 

aborted  or  no  previous  view 
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Function 


nna  inc 


rinq  dec 


display  top  ma 


unified  paint  square  reqion 


display  views 


Calls 


Where  Described 


this  file 


this  file 


Display  top.c 


New  zoom.c 


this  file 


Table  2.3.7.3*2:  Function  Summary 


Return  Values 


Return  Value 


1 


-  test  frontO 


Meanin 


buffer  preceeding  the  front 
doesn't  match  the  current 
viewport  real  coordinates 


successful 


1  Calls 

Function 

Where  Described 

rinq  dec 

this  file 

Concurrent  qraphics  library  subroutine 


Table  2.3,7.3-3:  Function  Summary  -  next_view() 
This  function  display  the  “next”  view,  if  any. 


Return  Values 


e 


int 


Return  Value 


Meanin 


no  more  views  to  displa 


Function 


display  top  ma 


unified  paint  square  reqion 


rinq  inc 


display  views 


Calls 


Where  Described 


Display  top.c 


New  zoom.c 


this  file 


this  file 


Table  2.3.7.3-4:  Function  Summary  -  add_view() 
This  function  is  called  after  a  new  view  is  created. 


Function 


rrsi 


rinq  inc 


display  views 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


this  file 


this  file 
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Table  2.3.7.3-5:  Function  Summary  -  ring_dec(  ring_var,  ring_size  ) 


1  Parameters 

Parameter 

Where  Tvoedef  Declared 

rinq  var 

int 

standard 

rinq  size 

int 

standard 

Return  Values 


Return  Value 


var 


Meanin 


inteaer  value  of  rinq  var 


Table  2.3.7.3-6:  Function  Summary  -  ring_inc(  ring_var,  ring_size  ) 


Parameters 


Parameter 


nnq  var 


Return  Value 


nnq  var 


Return  Values 


Where  Tvoedef  Declared 


standard 


standard 


Meanin 


inteqer  value  of  rinq  var 


Table  2.3.7.3-7:  Function  Summary  -  get_cached_bitmap(  xl,  yb,  xr,  yt  ) 

This  function  returns  a  file  descriptor  for  any  cached  bitmap  matching  the  current 
coordinates. 


Parameters 


Parameter 


xll 


Return  Values 


Return  Value 


-1 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Meanin 


failed  open 


Table  2.3.7.3-8:  Function  Summary  -  create_cached_bitmap(  xl,  yb,  xr,  yt) 
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Table  2.3.7.3-9:  Function  Summary  -  print_buffer_status() 

This  function  prints  the  current  state  of  the  view  ring_buffer.  It  displays  values  for 
view_ring_oldest,  view_ring_newest,  and  view_ring_fk>nt. 

Table  2.3.7.3-10:  Function  Summary  -  reset_views() 

This  function  sets  the  number  of  saved  views  to  zero.  It  is  used  when  changing  databases 
and  all  old  views  are  invalid. 


Function 


display  views 


Calls 


Where  Described 


this  file 


Table  2.3.7.3-11:  Function  Summary  -  display_views() 
This  function  displays  a  graphical  depiction  of  the  ring  buffer  as  an  aid  to  the  user. 


Function 


lUl!ll!li 


In 


moihue 


maisvncrb 


lino  inc 


maibox 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


this  file 


Concurrent  graphics  library  subroutine 


2. 3. 7. 4  objects. c 

This  CSU  enables  printing  a  description  of  a  moused  map  object.  This  file  interprets  the 
user's  gestures  with  the  mouse  and  invokes  the  appropriate  actions. 

Table  2.3.7.4-1:  Function  Summary  -  print_nearest_object(  map_x,  map  y) 
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2.4  PVD-LEVEL  PROCESSING 

This  CSC  provides  shared  data  types,  definitions,  shared  procedures  and  libranes. 

The  main  loop  of  the  PVD  includes  functions  that  get  the  next  available  packet  from  the 
network,  process  the  packet,  storing  data  and/or  undertaking  actions.  Positions  of  graphic 
icons  on  Ae  screen  are  updated,  based  on  packets  received.  The  main  loop  also  processes 
user  commands. 


This  CSC  ftmctionality  is  broken  down  into  lower-level  CSCs  shown  in  Figure  2-4. 


Figure  2-4:  PVD-Level  CSC  Structure. 
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2.4.1  Initial  PVD-Level  CSC  Description 
This  CSC  is  the  main  entry  for  PVD-level  processing. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.4. 1-1. 


Initial 

3.4.1 


pvd.c 
3.4.1. 1 


Figure  2.4.1«1:  PVD-Level-Initial  PVD-Level  CSC  Structure. 
2.4. 1.1  pvd.c 

This  CSU  provides  the  main  loop  of  the  PVD.  It  contains  routines  to  do  the  following 
things: 


-  Get  the  next  available  packet  from  the  network. 

-  Process  the  packet,  store  data  and/or  undertake  actions. 

-  Update  positions  of  graphics  icons  on  the  screen. 

-  Process  user  commands. 


Table  2.4.1. 1-1:  Function  Summary  -  exit_gracefully() 


1  Calls  1 

Function 

Where  Described 

thats  all  folks 

this  file 
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Table  2.4.1.1-2:  Function  Summary  -  exit_disgracefully() 


This  function  operates  like  exit  gracefully,  but  it  does  a  core  dump  rather  than  an  exit  (if 
CATC  is  being  used)  after  cleamng  up. 


1  Calls  1 

Function 

Where  Described 

thats  all  folks 

this  file 

catc  on 

Table  2.4.1. 1-3:  Function  Summary  •  thats_all_folks() 


1  Calls  1 

Function 

Where  Described 

maiflush 

Concurrent  qraphics  library  subroutine 

mqiclearpin 

Concurrent  qraphics  library  subroutine 

mqisyncrb 

Concurrent  qraphics  library  subroutine 

setup  back  fb 

New  zoom.c 

display  back  fb 

New  zoom.c 

Concurrent  qraphics  library  subroutine 

close  user  interface 

Pvd  iface.c 

clear  screen 

text.c 

net  qet  statistics 

ibneWa  in  MCC  CSCI 

close  c  sect  server 

terrain  pro.c 

table  uninit 

Table  2.4.1. 1-4:  Function  Summary  •  process_nonappearance_packets 

(process_special_packets~ ) 
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2.4.2  Shared  Definitions  CSC  Description 

This  CSC  provides  shared  definitions,  including  protocols,  for  PVD  Procedures. 
This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.4.2- 1. 
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2.4.3  Shared  Procedures  CSC  Description 

This  CSC  contains  procedures  and  libraries  used  by  more  than  one  CSC  in  the  PVD. 
This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.4.3- 1 . 

Shared 

Procedures 

3.4.3 


libassoc.a 
3.4.3. 1 

libmove.a 

3.43.2 

libshm.a 

3.4.33 

libnetif.a 

3.4.3.4 

Figure  2.4.3-1:  PVD-Level— Initial  PVD-Level  CSC  Structure. 

2.4.3. 1  libassoc.a 

This  CSU  implements  the  SIMNET  association  protocol. 

2. 4. 3. 2  libmove.a 
This  CSU  is  used  by  libnetif.a 

2. 4. 3. 3  libshm.a 

This  CSU  is  used  by  libnetif.a.  It  provides  access  to  shared  memory. 

2. 4. 3. 4  libnetif.a 

This  CSU  provides  a  low  level  interface  to  the  network. 
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2.5  UTILITIES 

This  CSC  includes  commonly-used  routines  that  support  text  input/output,  command  and 
options  processing,  map  and  icon  display  processing,  and  debugging. 

This  CSC  functionality  is  broken  down  into  lower-level  CSCs  shown  in  Figure  2-5. 


Figure  2-5:  Utilities  CSC  Structure. 
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2.5.1  General  Utilities  CSC  Description 
This  CSC  provides  general  PVD-level  utilities. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.5. 1-1. 


General 

Utilities 

3.5.1 


pvd_util.o 

3.5. 1.1 
pvd_ 

windows.c 

3.5. 1.2 

init_bell.c 

3.5. 1.3 


Figure  2.5. 1*1:  Utilities— General  Utilities  CSC  Structure. 


2.5. 1.1  pvd_util.c 

This  CSU  forces  an  integer  variable  to  lie  within  a  specified  range. 

Table  2.5.1. 1-1:  Function  Summary  -  force  to_range(i,  lower,  upper  ) 

This  function  forces  an  integer  variable  to  lie  within  a  specified  range,  “i”  is  the  value  to  be 
forced  within  the  range;  “lower”  and  “upper”  specify  the  lower  and  upper  limits  of  the 
range. 


Parameters 


Parameter 

j _ 

lower,  upper 


Type 

pointer  to  int 
int 


Where  Typedef  Declared 

standard _ 

standard _ 
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2.5. 1.2  pvd_windows.c  CSU  Description  (/simnet/pvd/lib/pvdiface.a) 


This  CSU  initializes  and  manages  the  windows  on  the  PVD  screen. 


Table  2.5.1.2-1:  Function  Summary  -  set_menu_window_top(  y  ) 
This  function  sets  the  value  of  the  menu  window  top. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

1 _ 

int 

standard 

Table  2.5.1.2-2:  Function  Summary  -  get_menu_window_top() 


1  Return  Values  1 

Return  Value 

Meanina 

window  menu  top 

int 

value  of  menu  window  top 

Table  2.5.1.2-3:  Function  Summary  -  init_windows() 


Ca 

lls 

Function 

Where  Described 

init  info  window 

this  file 

init  event  window 

this  file 

init  leqend  window 

this  file 

init  utm  window 

this  file 

Table  2.5.1. 2-4:  Function  Summary  •  init_info_window() 


1  Calls  1 

Function 

Where  Described 

mqidefw 

Concurrent  qraphics  library  subroutine 

Concurrent  qraphics  library  subroutine 

1  init  info  text  window 

this  file 

Table  2.5.1.2-5:  Function  Summary  -  init_info_text_window() 


Cal 

Is 

Function 

Where  Described 

mqimktwqw 

Concurrent  qraphics  library  subroutine 

draw  window  border 

Pvd  windows. c 

set  text  window 

T  windows.c 

Concurrent  qraphics  library  subroutine 
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Table  2.5.1.2-6:  Function  Summary  -  init_event_window() 


Function 


maidefw 


init  event  text  window 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araohics  library  subroutine 


this  file 


Table  2.5. 1.2-7;  Function  Summary  -  init_event_text_window() 


Function 


imktw 


draw  window  border 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Pvd  iface.c 


Table  2.5.1.2-8:  Function  Summary  -  reinit_event_text_window() 


Function 


maimktw 


draw  window  border 


Calls 


Where  Described 


Concurrent  Graphics  library  subroutine 


Pvd  windows.c 


Table  2.5. 1.2-9;  Function  Summary  -  erase_event_window_border() 


Function 


In 


mqihue 


imode 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  Graphics  library  subroutine 


Table  2.5.1.2-10;  Function  Summary  -  init_time_window() 


Function 


idetw 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.5.1.2-11;  Function  Summary  -  init_legend_window() 


Function 


idefw 


w 


draw  window  border 


display  key  text 


Calls 


Where  Described 


Concurrent  Graphics  library  subroutine 


Concurrent  Graphics  library  subroutine 


Pvd  windows.c 


Pvd  windows.c 
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Table  2.5.1.2-12:  Function  Summary  -  display_map_key() 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


•C 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


this  file 


miamode 


In 


disolay  stri 


maihue 


ibox 


disolay  mao  key  text 


Table  2.5.1.2-13:  Function  Summary  -  display_map_key_text() 


Function 


maimode 


In 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.5.1.2-14:  Function  Summary  -  default_mouse_help() 


Calls 

Function 

Where  Described 

mqiclearpin 

Concurrent  araohics  library  subroutine 

mqimode 

Concurrent  araohics  library  subroutine 

uiisuiii 


Concurrent  araohics  library  subroutine 


Table  2.5.1.2-15:  Function  Summary  -  freedraw_mouse_help() 


Calls 

Function 

Where  Described 

mqiclearpin 

Concurrent  araohics  library  subroutine 

mqimode 

Concurrent  qraphics  library  subroutine 

In  Concurrent  araohics  library  subroutine 


Table  2.5.1.2-16:  Function  Summary  -  resize_mouse_help() 
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Table  2.5.1.2-17: 

Function  Summary  •  move_mouse_help() 

1  Calls  1 

1  Function 

Where  Described 

i  1  II II  1 1  II  — 

Concurrent  graphics  library  subroutine 

1  mgimode 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

Table  2.5.1.2-18:  Function  Summary  •  abort_mouse_help() 


Calls 


Function 


mqimode 


In 


cn 


Where  Described _ 

Concurrent  graphics  library  subroutine 
Concurrent  graphics  library  subroutine 
Concurrent  graphics  library  subroutine 


Table  2.5.1.2-19:  Function  Summary  -  catc_place_tgt_mvr_mouse_help{) 


Calls 

Function 

Where  Described 

mgiclearpin 

Concurrent  graphics  library  subroutine 

mgimode 

Concurrent  graphics  library  subroutine 

Concurrent  graohics  library  subroutine 


Table  2.5.1.2-20:  Function  Summary  -  catc_place_tgt_mouse_help() 


Calls 

Function 

Where  Described 

mgiclearpin 

Concurrent  graphics  library  subroutine 

mgimode 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 


GK 


Table  2.5.1.2-21:  Function  Summary  - 
catc_move_tgt_pickup_mouse_help() 


Calls 

Function 

Where  Described 

mgiclearpin 

Concurrent  graphics  library  subroutine 

mgimode 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 
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Table  2.5.1.2-22:  Function  Summary  -  catc_move_tgt_pIace_mouse_heIp() 


1  Calls  1 

Function 

Where  Described 

mqiclearpin 

Concurrent  qraphics  library  subroutine 

moimode 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

Table  2.5.1.2-23:  Function  Summary  -  catc_remove_tgt_mouse_help() 


1  Calls  1 

Function 

Where  Described 

maiclearpln 

Concurrent  qraphics  library  subroutine 

mqimode 

Concurrent  qraphics  library  subroutine 

Concurrent  qraphics  library  subroutine 

Table  2.5.1.2-24:  Function  Summary  -  display_mouse_key() 


_ Calls _ 

Function  I  Where  Described 

mouse  info  I 


Table  2.5.1.2-25:  Function  Summary  -  set_mouse_text(  func  ) 


Table  2.5.1.2-26:  Function  Summary  -  display_intervis_key() 
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Table  2.5.1.2-27:  Function  Summary  -  display_intervis_key_text() 


Function 


et  view  heiaht 


et  taraet  heiaht 


et  view  ranae 


In 


Calls 


Where  Described 


Get  view.c 


Get  view.c 


Get  view.c 


Concurrent  araphics  Kbrary  subroutine 


Table  2.5.1.2-28:  Function  Summary  -  display_icon_key() 


Function 


iciearpin 


iv 


maimode 


In 


mqihue 


maiseaimm 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.5.1.2-29:  Function  Summary  -  display_icon_key_text() 


Function 


In 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Table  2.5.1.2-30:  Function  Summary  -  draw_fixed_faad 
(  hull_huey  turret_hue  )  ~ 


Parameters 


Parameter 


hull  hue 


turret  hue 


Function 


imode 


mqihue 


maibox 


maisvncrb 


Where  Typedef  Declared 


standard 


standard 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.5.1.2-31:  Function  Summary  -  draw_rixed_fwa(  hull_hue  ) 


Parameters 


Parameter 


hull  hue 


Where  Typedef  Declared 


standard 
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Function 


I  mode 


maihue 


maibox 


isyncrb 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  oraphics  fibrary  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.5.1.2-32:  Function  Summary  -  draw_nxed_m2 
(  hull  hue,  turret  hue  )  ~ 


Parameters 


Parameter 


hull  hue 


turret  hue 


Where  Typedef  Declared 


standard 


standard 


Function 


imode 


maihue 


maibox 


il 


maisyncrb 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.5.1.2-33:  Function  Summary  -  draw_fixed_tank 
(huli_hue,  turret_hue  ) 


Parameters 


Parameter 


hull  hue 


turret  hue 


Where  Typedef  Declared 


standard 


standard 


Function 


maimode 


maihue 


maisyncrb 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.5.1.2-34:  Function  Summary  -  draw_fixed_static 
(  hull_hue,  turret_hue  )  ~  ~ 
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Function 


imode 


maihue 


ibox 


isvncrb 


Calls 


Where  Described 


Concurrent  araohics  Hbrary  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.5.1.2-35:  Function  Summary  -  draw_flxed_burst(  hue  ) 


Parameters 


Parameter 


hue 


Where  Tvoedef  Declared 


standard 


I  Calls  1 

Function 

Where  Described 

maimode 

Concurrent  araohics  library  subroutine 

mgihue 

Concurrent  araohics  library  subroutine 

isyncrb 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.5.1.2-36:  Function  Summary  •  display_key_text() 


Function 


display  mao  ke 


display  intervis  ke 


Calls 


Where  Described 


Pvd  windows.c 


Pvd  windows.c 


Table  2.5.1.2-37:  Function  Summary  -  init_utm_window() 
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Table  2.5.1.2-38:  Function  Summary  -  get_exercise_time(  num_packets  ) 


Parameter 


num  packets 


Return  Value 


time 


Parameters 


Return  Values 


Where  Typedef  Declared 


standard 


Meanin 


lints  time  in  hrs,  mms,  secs 


Table  2.5.1.2-39:  Function  Summary  -  display_time(  start_time  ) 


Parameters 


Parameter 


start  time 


Where  Typedef  Declared 


standard 


Table  2.5.1.2-40:  Function  Summary  -  init_zone_window() 


Function 


idefw 


w 


draw  zone 


lu^ 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  Graphics  library  subroutine 


Table  2.5.1.2-41:  Function  Summary  -  draw_window_border 
(  top,  bottom,  left,  right  ) 


Parameter 


Parameters 


Where  Typedef  Declared 


standard 


standard 


standard 


standard 


Function 


iv 


In 


maihue 


maimode 


Calls 


Where  Described 


Concurrent  Graphics  library  subroutine 


Concurrent  Graphics  library  subroutine 


Concurrent  Graphics  library  subroutine 


Concurrent  Graphics  Nbrary  subroutine 


Concurrent  Graphics  library  subroutine 


Table  2.5.1.2-42:  Function  Summary  -  init_zoom_scale() 


Function 


calc  zoom  Scale 


Calls 


Where  Described 


this  file 
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Table  2.5.1.2-43:  Function  Summary  -  calc_zoom_scale() 


Ca 

is 

Function 

Where  Described 

Concurrent  araohics  library  subroutine 

1  maimode 

Concurrent  araohics  library  subroutine 

Concurrent  araohics  library  subroutine 

1  maihue 

Concurrent  araohics  ibrary  subroutine 

Concurrent  araohics  library  subroutine 

Table  2.5.1.2-44:  Function  Summary  -  iniMcon_scale() 


1  Calls  1 

Function 

Where  Described 

write  strina 

Write  strina.c 

Table  2.5.1.2-45:  Function  Summary  -  show_icon_scale(  icon_scale  ) 


Parameters 


Parameter 


icon  scale 


Function 


imode 


moiv 


In 


maihue 


moibox 


Where  Tynedef  Declared 


standard 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.5.1.2-46:  Function  Summary  -  init_exercise() 


1  Calls  1 

Function 

Where  Described 

chanae  exercise 

this  file 

Table  2.5.1.2-47:  Function  Summary  -  change_exercise() 


Function 


maimode 


iv 


In 


maihue 


maibox 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 
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Table  2.5.1.2-48:  Function  Summary  -  change_intervis_key_text() 


Ca 

Is 

Function 

Where  Described 

display  intervis  key 

Pvd  windows.c 

2.5. 1.3  lnit_bell.c 

This  CSU  sets  up  the  bell  for  the  Masscomp  graphics  terminal. 

2.5.2  Text  Input/Output  CSC  Description 
This  CSC  provides  text  input/output  capability. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2  .5.1-1. 

Text  Input/ 

Output 

3.5.2 


type_to.c 
3.5.2. 1 

t_ 

windows.c 

3.5.22 

interact.c 

3.5.23 

Figure  2.5.2-1:  Utilities— Text  Input/Output  CSC  Structure. 

2.5.2. 1  type_to.c 

This  CSU  outputs  a  string  to  a  particular  device. 
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Table  2.5.2.1>1:  Function  Summary  -  type_to_device(  echo_string,  device  ) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

echo  strina 

pointer  to  char 

standard 

device 

pointer  to  char 

standard 

2. 5.2.2  t_windows.c 
This  CSU  sets  the  text  window. 


Table  2.5.2.2-1:  Function  Summary  -  set_text_window(  t_window  ) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

t  window 

pointer  to  char 

standard 

2. 5. 2. 3  interact.c 

This  CSU  manages  interactive  keyboard  input.  It  gives  prompt  strings  and  receives  input. 


Table  2.5.2.3-1:  Function  Summary  -  get_typed_input(  prompt  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

prompt 

pointer  to  char 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meanlnp 

user  input 

char 

pointer  to  user  input 

Table  2.5.2.3-2:  Function  Summary  -  get_typed_input_float 
(  prompt,  default_val  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

prompt 

pointer  to  char 

standard 

default  val 

float 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

user  input 

float 

pointer  to  user  input 
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Table  2.5.2.3-3:  Function  Summary  -  get_typed_input_str 
(  prompt,  default_str  ) 


Parameter 


romot 


default  str 


Parameters 


inter  to  char 


inter  to  char 


Where  Tynedef  Declared 


standard 


standard 


Return  Value 


user  buffer 


Return  Values 


Meanin 


inter  to  user  buffer 


Table  2.5.2.3-4:  Function  Summary  -  input_name(  prompt, 
user_buffer,  default_str  ) 
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2.5.3  Input  Processing  CSC  Description 

This  CSC  processes  commands  and  command  options  and  other  forms  of  user  input. 
This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.5.3- 1 . 

Input 

Processing 

3.5.3 


u_flags.c 
3.5.3. 1 

move.c 

35.3.2 

pvdjface.c 

3.5.33 

libmove.a 

3.53.4 

init_flags.c 

3.5.3.5 

seleclc 

3.5.3.6 


Figure  2.5.3-1:  Utilities—Input  Processing  CSC  Structure. 


2.5.3. 1  u_flags.c 

This  CSU  stores  the  information  from  the  command  line. 


Table  2.5.3.1-1:  Function  Summary  -  process_unix_nags 
(  argc,  argv,  unix_flags  ) 

This  function  stores  the  information  fromt  the  command  line. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

aroc 

int 

standard 

arov 

pointer  to  char 

standard 

Unix  flaos 

pointer  to  struct  U  FLAGS 

u  flaps,  h 
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2. 5. 3. 2  move.c  CSU  Description  (/simnet/pvd/lib/pvdiface.a) 

This  CSU  enables  selecting  a  region  of  terrain  with  select_region.  This  file  interprets  the 
user's  gestures  with  the  mouse  and  invoke  the  appropriate  actions. 


Table  2.5.3.2-1:  Function  Summary  -  move_window(  w  ) 


Parameters 


Parameter 


Function 


et  window  num 


etfb 


etcursx 


mqietwioc 


mqrqetwioc 


constrain  to  screen 


mqifb 


In 


mqihue 


mqibox 


mqisvncrb 


mqifbfbex 


Where  Tvoedef  Declared 


standard 


Calls 


Where  Described 


Pod  windows.c 


Concurrent  oraohics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraohics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


this  file 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Table  2.5.3,2-2:  Function  Summary  -  clear_window(  w  ) 
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Table  2.5.3.2-3:  Function  Summary  -  select_region(  x,  y  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

_ 

ini 

standard 

Ca 

lls 

Function 

Where  Described 

set  mark 

pvd  iface.c 

Concurrent  araphics  library  subroutine 

set  first  point 

pvd  iface.c 

set  point 

pvd  iface.c 

Table  2.5.3.2-4:  Function  Summary  •  constrain_to_screen(  xU  yb,  xr,  yt, 
screen_xl,  screen_yb,  screen_xr,  screen_yt  ) 

This  function  forces  a  rectangular  region  to  be  within  the  screen.  It  assumes  the  region  will 
fit  on  the  screen.  The  region  is  translated  the  smallest  possible  distance  to  put  it  on  the 
screen. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

IllfHH  — — ■ 

pointer  to  int 

standard 

screen  xl 

int 

standard 

screen  vb 

int 

standard 

screen  xr 

int 

standard 

screen  yt 

int 

standard 

1  Calls  1 

Function 

Where  Described 

get  window  num 

Poo  windows.c 

2. 5. 3. 3  pvd_iface.c 

This  CSU  enables  a  point  to  be  selected.  This  file  interprets  the  user’s  gestures  with  the 
mouse  and  invokes  the  appropriate  actions. 
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Table  2.5.3.3-1:  Function  Summary  -  init_user_interface() 


Function 


maibuttonint 


mqiwidth 


I  nit  fonts 


init  menus 


icursmode 


draw  setup  menu 


init  workinq  cursor 


init  windows 


make  path  name 


et  db  directo 


Calls 


Where  Described 


Concurrent  qraphics  Hbrary  subroutine 


Concurrent  qraphics  tibrary  subroutine 


this  file 


Menu.c 


Concurrent  qraphics  fibrarv  subroutine 


Menu.c 


this  file 


Pvd  windows.c 


init  env.c 


init  env.c 


Table  2.5.3.3-2:  Function  Summary  •  init_fonts() 


Calls 

Function 

Where  Described 

mqifetchqf 

Concurrent  qraphics  library  subroutine 

mqideltf 

Concurrent  qraphics  library  subroutine 

Concurrent  qraphics  library  subroutine 


Table  2.5.3.3-3:  Function  Summary  -  close_user_interface() 


Function 


icursmode 


mqisyncrb 


Function 


mqiloadcurs 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Table  2.5.3.3-4;  Function  Summary  -  init_cursor() 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Table  2.5.3.3*5:  Function  Summary  -  init_working_cursor() 


Function 


mqiloadcurs 


Calls 


Where  Described 


Concurrent  qraphics  libra 


Table  2.5.3.3-6:  Function  Summary  -  init_cross_cursor() 


Function 


mqiloadcurs 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 
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Table  2.5.3.3-7:  Function  Summary  -  button(  x,  y,  s  ) 


Parameters 


Ein 


unsiqned  int 


unsioned  int 


unsioned  int 


Where  Tynedef  Declared 


standard 


standard 


standard 


Table  2.5.3.3-8:  Function  Summary  -  handIe_mouse(  mouse  ) 


Parameters 


Parameter 


mouse 


Where  Tvoedef  Declared 


standard 


i  Calls 

Function 

Where  Described 

handle  popup  windows 

Pop  windows.c 

handle  menu 

Menu.c 

lect  reoion 


add  selected  point 


handle  hiohliaht  point 


rint  nearest  object 


Move.c 


this  file 


handle  input.c 


Objects. c 


Table  2.5.3.3>9:  Function  Summary  •  set_mark(  x,  y  ) 


Table  2.5.3.3-1  "unction  Summary  •  set_first_point(  x,  y  ) 
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Table  2.5.3.3-11:  Function  Summary  -  set_point(  x,  y  ) 


Parameter 


Parameters 


Where  Typedef  Declared 


standard 


standard 


Calls 


Function 

Where  Described 

toaale  selected 

this  file 

Table  2.5.3.3-12:  Function  Summary  •  toggle_selected(  hue  ) 
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Table  2.5.3.3-14:  Function  Summary  -  xy_get_coord(  x,  y  ) 


Parameters 


Parameter 


Function 


et  elevation 


ixel  to  user 


IV 


In 


mqihue 


moimode 


ibox 


Where  Tvoedef  Declared 


standard 


standard 


Calls 


Where  Described 


Get  elev.c 


this  tile 


Concurrent  graphics  Nbrary  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Table  2.5.3.3-15:  Function  Summary  -  user_to_pixel(  px,  py,  rx,  ry  ) 


Parameter 


Parameters 


e 


inter  to  int 


inter  to  int 


float 


float 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Function 


Calls 


Where  Described 


Concurrent  graphics  library  subroutine 


Table  2.5.3.3-16:  Function  Summary  -  pixel_to_user(  px,  py,  rx,  ry  ) 


Parameters 


Parameter 


inter  to  float 


inter  to  float 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Function 


rrsi 


Calls 


Where  Described 


Concurrent  graphics  library  subroutine 


Table  2.5.3.3-17:  Function  Summary  -  add_selected_point(  x,  y  ) 


Parameters 


Parameter 


Where  Tvoedef  Declared 


standard 


standard 
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Table  2.5.3.3-18:  Function  Summary  -  currentJoc(  x,  y  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

X 

float 

standard 

1 _ 

float 

standard 

Ca 

Is 

Function 

Where  Described 

morscalexv 

Concurrent  araohics  librarv  subroutine 

tdb  Qiv  XV  oet  utm 

see  libfdb  in  MCC  CSCI 

Concurrent  araohics  librarv  subroutine 

Concurrent  araohics  librarv  subroutine 

1  maihue 

Concurrent  araohics  librarv  subroutine 

Corx:urrent  araohics  Nbrarv  subroutine 

Table  2.5.3.3-19:  Function  Summary  -  xy_current_loc(  x,  y  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

X 

real 

standard 

1 _ 

real 

standard 

Ca 

Is 

Function 

Where  Described 

Concurrent  araohics  Kbrarv  subroutine 

Concurrent  araohics  librarv  subroutine 

Concurrent  araohics  librarv  subroutine 

mqihue 

Concurrent  araohics  Kbrarv  subroutine 

maimode 

Concurrent  araohics  library  subroutine 

Concurrent  araohics  library  subroutine 

2. 5. 3. 4  libmove.a 

This  is  a  common  library  used  by  PVD  and  other  SIMNET  applications. 

2.5. 3.5  init_flags.c 

This  CSU  initializes  the  global  flags  used  to  communicate  between  the  main  loop  and  the 
menu  system. 

2.5. 3.6  select.c  CSU  Description  (/simnet/pvd/lib/pvdiface.a) 

This  CSU  contains  routines  for  selecting  vehicles. 
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Table  2.5.3.6-1:  Function  Summary  •  tank_selected(  id  ) 


Parameters 


Parameter 


id 


Return  Value 


1 


Return  Values 


Where  Tvnedef  Declared 


standard 


Meanin 


assed  tank  id  selected 


not  selected 


Table  2.5.3.6-2:  Function  Summary  •  toggle_nearest_tank(  x,  y  ) 


Parameters 


Parameter 


Return  Values 


Return  Value 


1 


Where  Typedef  Declared 


standard 


standard 


Meanin 


int 

tank  was  nearby  and  its 
hiQhliqht  state  was  togqied 

int 

not  the  above 

Function 


et  true  icon  scale 


et  world  state 


rrsi 


add  selected  tank 


detail  displa 


remove  Selected  tank 


Calls 


Where  Described 


Icon.c 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


this  file 


Detail.c 


this  tile 


Table  2.5.3.6-3:  Function  Summary  -  remove_selected_tank(vehicle_index) 
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Table  2.5.3.6-4:  Function  Summary  -  add_selected_tank(  vehicle_index  ) 

This  function  adds  the  vehicle  indicated  by  the  passed  vehicle_index  to  the  list  of  selected 
vehicles. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

vehicle  index 

int 

standard 

1  Calls  1 

Function 

Where  Described 

hiQhliaht  tank 

HiQhliQht.c 

Table  2.5.3.6-5:  Function  Summary  -  my_min(  x,  y  ) 


Parameters 


Parameter 


Where  Tynedef  Declared 


standard 


standard 


Return  Values 


Return  Value 


Table  2.5.3.6>6:  Function  Summary  -  my_max(  x,  y  ) 


Parameters 


Parameter 


Where  TvDedef  Declared 


standard 


standard 


Return  Values 


Return  Value 


Table  2.5.3.6-7:  Function  Summary  •  vehicle_in_region(  x,  y,  region  ) 
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Ca 

Is 

Function 

Where  Described 

my  min 

this  file 

this  file 

1  marscalexy 

Concurrent  araphics  library  subroutine 

Table  2.5.3.6*8:  Function  Summary  -  clear_selected_vehicles() 


Calls 

Function 

1  Where  Described 

unhiQhliaht  tank  I  Hiahliaht.c 


Table  2.5.3.6-9:  Function  Summary  -  select_vehicle_by_name() 


This  function  causes  the  entered  vehicle  to  become  selected.  If  the  entered  string  is  a  vehicle 
id,  vehicles  are  searched  for  a  matching  id.  If  no  match,  the  passed  string  is  compared  to 
vehicle  markings. 


i  Calls  1 

Function 

Where  Described 

get  typed  input  str 

interact.c 

get  world  state 

is  vehicle  id  string 

this  file 

vehicle  id  cmp 

this  file 

add  selected  tank 

this  file 

detai;  display 

Detail.c 

Table  2.5.3.6*10:  Function  Summary  •  is  vehicle_id_string 
(  input_string,  vehicle_id  1 
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Table  2.5.3.6-11:  Function  Summary  -  vehicle  id_cmp 

(  vehicle_id_l,  vehicle  id  2)  ~ 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

vehicle  id  1 

pointer  to  VehiclelD 

basic.h 

vehicle  id  2 

pointer  to  VehiclelD 

basic.h 

I  Return  Values  I 

Return  Value 

Meanina 

1 

int 

Contents  of  the  passed  vehicle 
ids  are  equal 

0 

int 

Otherwise  than  above 

2.5.4  Customization  CSC  Description 

This  CSC  provides  customizing  parameters  for  PVD  functions. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.5.4- 1. 

Customi¬ 

zation 

3.5.4 


init_env.c 
3.5.4. 1 

text.c 

3.54.2 


Figure  2.5.4-1:  Utilities— Customization  CSC  Structure. 
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2.5.4. 1  init_env.c 

This  CSU  contains  routines  for  initializing  the  environment  in  PVD. 


Table  2.5.4.1>1:  Function  Summary  -  init_environment() 
This  function  reads  environment  variables  from  a  file. 


Return  Values 


Return  Value 


1 


Meanin 


successful 


failed 


Function 


et  stealth  address 


flaa  stealth  menu 


flaa  catc  menu 


set  default  menu 


set  time  out  msec 


set  exercise 


set  firefinder 


set  bfit  mode 


set  nios  mode 


Calls 


Where  Described 


this  file 


Menu.c 


Menu.c 


Menu.c 


Puroe.c 


Pvd  misc.c 


Indir  fire.c 


Table  2.5.4.1-2:  Function  Summary  -  get_data_directory() 


Return  Values 


Return  Value 


ENVVIRON.data  directo 


Table  2.5.4.1-3:  Function  Summary  -  get_vr_host() 


Return  Value 


ENVIRON.vr  host 


irs 


Return  Values 


inter  to  char 


Meanin 


value  of  vr  host 


Table  2.5.4.1-4:  Function  Summary  -  get_pt_host() 
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Table  2.5.4.1>S:  Function  Summary  -  get_rc_host() 


Return  Value 
ENVIRON.rc  host 


Return  Values 


Meanin 


value  of  rc  host 


Table  2.5.4.1-6:  Function  Summary  -  get_dp_address() 

Return  Values  _ 

Return  Value _  Type _ Meaning _ 

ENVIRON. dp  address _ pointer  to  unsigned  char _ value  of  dp  address 


Table  2.5.4.1-7:  Function  Summary  •  get_db_directory() 


Table  2.5.4.1-8:  Function  Summary  -  make_path_name 
(  directory,  file_name,  path  ) 


This  function  copies  the  supplied  directory  name  and  file  name  into  the  specified  string. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

directory 

pointer  to  char 

standard 

file  name 

pointer  to  char 

standard 

path 

pointer  to  char 

standard 

I 


Table  2.5.4.1-9:  Function  Summary  -  get_discrete_zoom_levels() 


This  function  returns  a  pointer  to  an  array  of  desired  discrete  zoom  levels. 


1  Return  Values  1 

Return  Value 

Meaning 

ENVIRON.discrete_zoom_ 

levels 

pointer  to  int 

value  of  discrete.zoomjevels 

Table  2.5.4.1-10:  Function  Summary  -  get_patches_to_cache() 
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Table  2.5.4.1-11:  Function  Summary  -  get_stealth_address() 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

&ENVIRON.stealth  address 

pointer  to  SimulationAddress 

pointer  to  stealth  address 

Table  2.5.4.1-12:  Function  Summary  •  get_db_names(  entry_num  ) 


1  Parameters  1 

1  Parameter 

Where  Tvpedef  Declared 

int 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

&(  EN  VI  RON  .database.names 
fentrv  numh 

pointer  to  DB_NAMES 

pointer  to  db_names 

2. 5. 4. 2  text.c 

This  CSU  contains  routines  that  control  the  text  display  of  vehicle  states  in  PVD. 


Table  2.5.4.2-1:  Function  Summary  -  text_display(  world_state  ) 


i  Parameters  1 

Parameter 

Where  Typedef  Declared 

world_state 

pointer  to  struct  WORLD 

STATE 

world_state.h 

ca 

Is 

Function 

Where  Described 

find  closest 

get  screen  size 

this  file 

print  header 

this  file 

this  file 

move  cursor  to 

this  file 

print  vehicle  id 

Pvd.misc.c 

out.  of  range 

Pvd  misc.c 

prepare  line 

this  file 

print  vehicle 

this  file 

Table  2.5.4.2-2:  Function  Summary  -  ciear_screen() 
This  function  clears  the  screen. 


Table  2.5.4.2-3:  Function  Summary  -  home() 


This  function  returns  the  cursor  to  the  upper  left-hand  comer  of  the  screen. 
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Table  2.S.4.2-4;  Function  Summary  -  move_cursor_to(  line,  column  ) 


This  function  moves  the  cursor  to  a  given  line  and  column  on  ANSI  compatible  terminals. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

line 

int 

standard 

column 

int 

standard 

Table  2.5.4.2-5:  Function  Summary  -  prepare_line(  line_number  ) 

This  function  clears  the  specified  line  on  the  screen  and  leaves  the  cursor  at  the  beginning 
The  first  line  on  the  screen  is  line  1. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

line  number 

int 

standard 

Table  2.5.4.2-6:  Function  Summary  -  print_header(  line_num  ) 

This  function  prints  the  column  headers  for  the  vehicle  display.  It  does  not  output  a 
newline. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

line  num 

int 

standard 

1  Calls  1 

Function 

Where  Described 

prepare  line 

this  file 

Table  2.5.4.2-7:  Function  Summary  -  print_vehicle(  appearancePDU, 

statusPDU) 

This  function  prints  a  one-line  descriptionof  the  passed  vehicle’s  state.  Line  is  not 
terminated  with  a  newline. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

appearancePDU 

pointer  to  SimulationPDU 

p  sim.h 

statusPDU 

pointer  to  DataCollectionPDU 

p  data.h 
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Table  2.5.4.2-8:  Function  Summary  -  kph(  vel_array  ) 

This  function  converts  an  array  of  three  component  velocities  (in  meters  per  second)  to 
kilometers  per  hour. 


Table  2.5.4.2-9:  Function  Summary  -  display_int_at(  row,  col, 

format,  value  ) 


This  function  displays  an  integer  at  the  specified  row  and  column  coordinates.  The  int  is 
displayed  by  printf  as  specific  in  the  passed  string. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

row 

int 

standard 

col 

int 

standard 

format 

pointer  to  char 

standard 

value 

int 

standard 
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Calls 

Function  I  Where  Described 

move  cursor  to  1  this  file 


Table  2.5.4.2-11:  Function  Summary  -  display_page_num 
(  current_page,  total_pages  ) 


This  function  displays  the  current  page  number  in  the  upper  right  comer  of  the  screen. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

current  paae 

int 

standard 

total  paces 

int 

standard 

i  Calls  1 

Function 

Where  Described 

move  cursor  to 

this  file 

Table  2.5.4.2-12:  Function  Summary  -  get_screen_size(  lines,  cols  ) 

This  function  returns  the  number  of  columns  and  lines  the  terminal  can  display.  NOTE:  it 
must  handle  the  graphics  SCTeen  (tty4)  as  a  special  case,  since  its  characteristics  are  not 
entered  in  the  environment  variable  “TERMCAP.” 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

lines 

pointer  to  int 

standard 

cols 

pointer  to  int 

standard 

Table  2.5.4.2-13:  Function  Summary  -  get_velocity(  a_variant  ) 


This  function  returns  the  speed  of  the  vehicle  in  kilometers  pers  hour. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

a_variant 

pointer  to 

VehicleAppearanceVariant 

p_sim.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0.0 

float 

0 

kph 

float 

Ml _ 

float 

_ Calls _ 

Function  [Where  Described 

print  vehicle  id  I  Pvd  misc.c 
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Table  2.5.4.2-14:  Function  Summary  -  get_turret_degrees(  a_variant  ) 


This  function  returns  the  direction  of  the  turret  with  relation  to  the  front  of  the  hull  in 
compass  degrees.  If  the  vehicle  has  no  turret,  it  returns  0.0. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

a_variant 

pointer  to 

Vehicle  AppearanceVariant 

p_sim.h 

1  Return  Values  1 

1  Return  Value 

Type 

Meaning 

1 

float 

vehicle  has  no  turret 

rad_to_deg 

float 

turret  position  in  compass 
degrees 

Table  2.5.4.2-15:  Function  Summary  -  get_gun_degrees(  a_variant  ) 
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2.5.5  Map/Icon  CSC  Description 

This  CSC  provides  commonly-used  Map/Icon  utilities.  This  CSC  functionality  is  broken 
down  into  the  CSUs  shown  in  Figure  2.5.5-1. 


Map/Icon 

Utilities 

3.5.5 


find_near.c 

3.5.5.1 


measures.c 

3.5.5.2 


Figure  2.5.5-1;  Map/Icon  -CSC  Structure. 


2.5.5. 1  find_near.c 

This  CSU  finds  the  nearest  point  on  a  route. 


Table  2.5.5.1-1:  Function  Summary  -  find_nearest_route_pt(  route,  point, 

end_points_only,  testjx,  test_y  ) 

This  function  finds  the  nearest  point  on  a  route.  It  returns  a  pointer  to  the  route  and  a 
pointer  to  the  point.  If  end_points_only  is  nonzero,  it  only  considers  the  two  endpoints  of 
each  route.  A  nil  route  indicates  no  route  found. 

Note:  triangles  are  assumed  always  to  be  the  same  size  in  pixels. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

route 

pointer  to  pointer  to  ROUTE 

ovetlay.h 

point 

pointer  to  pointer  to  ENDPT 

overlay  .h 

end  points  only 

int 

standard 

III  nm  III'— — 

float 

standard 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  graphics  library 
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2.S.S.2  measures.c 


This  CSU  contains  routines  that  compute  tank  headings,  turret  orientations,  and  gun 
elevations  in  compass  radians. 


Table  2.5.5.2-1:  Function  Summary  •  heading(  hulI_to_world  ) 


This  function  computes  the  tank’s  heading  in  radians.  Heading  is  expressed  in  “compass 
radians”,  that  is,  radians  measured  clockwise  from  due  “north”  The  returned  values  range 
from  -pi  to  +pi. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

hull  to  world 

float 

standard 

1  Return  Values  I 

Return  Value 

Meanina  i 

radians 

real 

Table  2.5.5.2-2:  Function  Summary  -  heading_fraction(  huII_to_world  ) 

This  function  returns  the  heading  of  the  vehicle  as  a  32-bit  binary  fraction  of  a  circle  (0  is 
N,  increasing  clockwise.) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

hull  to  world 

float 

standard 

Table  2.5.5.2-3:  Function  Summary  -  rel_turret{  turret_az  ) 

This  function  returns  the  orientation  of  the  turret  with  relation  to  the  hull  in  compass 
radians.  It  returns  a  value  in  the  range  0  to  2  *  PI. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

turret  az 

unsiqned  Iona 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

2.0  *  PI  -  ((float)turret  az)/ 

(TWO  TO  THE  32)  *  2.0  *  PI) 

real 

range  of  0  to  2  *  pi 
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Table  2.5.5.2-4:  Function  Summary  -  rel_gun(  gun_el  ) 


This  function  returns  the  elevation  of  the  gun  above  the  hull  plane  in  radians.  It  returns  a 
value  in  the  range  -PI  to  PI. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Qun  el 

unsiqned  Iona 

standard 

Table  2.5.5.2-S:  -  Function  Summary  -  angle_normalize(  rads  ) 


This  functions  puts  an  angle  in  radians  within  the  range  -PI  to  PI. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

rads 

float 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

rads 

float 

range  of  -  pi  to  +pi 

Table  2.5.5.2>6:  Function  Summary  -  dist2(  from_x,  from_y,  to_x,  to_y  ) 
This  function  returns  a  two-dimensional  distance. 


1  Parameters  1 

1  Parameter 

Where  Typedef  Declared 

float 

standard 

Ito  X,  to  y 

float 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

sqrt(  delta x  *  delta x  +  detta y 

‘delta  y) 

float 

two-dimensional  distance 

Table  2.S.5.2-7:  Function  Summary  •  dist_3(  xO,  yO,  zO,  xl,  yl,  zl  ) 
This  function  returns  a  three-dimensional  distance. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

xO.  vO.  zO 

float 

standard 

_ 

float 

standard 

1  Return  Values  1 

Return  Value 

Meaning 

sqrt(  dx  *  dx  +  dv  *  dv  +  dz  *  dz ) 

float 

three-dimensional  distance 
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Table  2.5.5.2-8:  Function  Summary  -  cmc_msec(  sec  ) 
This  function  converts  seconds  to  cmc  “milliseconds.” 


2.5.6  Debug  CSC  Description 
This  CSC  provides  debugging  routines. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.5.6- 1. 


Figure  2.5.6-1:  Utilities—Debug  CSC  Structure. 
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2.5.6. 1  memory. c 

This  CSU  contains  routines  for  determining  the  amount  of  free  memory  available. 


Table  2.5.6.1>1:  Function  Summary  -  get_all_memory(  last_chunk) 

This  function  returns  an  estimate  of  the  total  amount  of  memory  available,  and,  in 
‘last_chunk’,  a  tolerance  on  this  estimate.  It  attempts  to  allocate  all  of  dynamic  memory  in 
order  to  see  how  much  there  is. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

last  chunk 

pointer  to  int 

standard 

1  Return  Values  1 

Return  Value 

Meanina 

sum 

int 

Number  of  bytes  in  last  chunk 
of  memory  allocated;  0  means 
QOt  it  all 

Table  2.5.6.1-2:  Function  Summary  -  get_biggest_memory_chunk(  chunk  ) 

This  function  returns  the  size  in  bytes  of  the  single  largest  chunk  of  memory  that  could  be 
malloc’ed.  The  int  pointed  to  by  the  argument  is  set  to  the  address  of  this  chunk. 


Parameters  1 

Parameter 

Where  Typedef  Declared 

chunk 

pointer  to  int 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

current 

int 

Number  of  bytes  of  largest 
chunk  of  memory  that  can  be 
malloced. 

0 

int 

error 

2. 5. 6. 2  tell.c 

This  CSU  displays  in  the  event  window  the  screen  coordinates  of  the  map  window,  map 
coordinates,  and  mouse  locations.  (Used  for  debugging  purposes.) 


Table  2.5.6.2-1:  Function  Summary  -  tell_all() 


Ca 

Is 

Function 

Where  Described 

Concurrent  graphics  library  subroutine 

1  mgrqetwioc 

Concurrent  graphics  library  subroutine 
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Table  2.5.6.2-2:  Function  Summary  -  tell_real() 


1  Calls  1 

1  Function 

Where  Described 

Concurrent  graphics  library  subroutine 
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2.6  NETWORK  PROCESSING 

This  CSC  initializes  and  sends  packets  based  on  user  inputs.  It  also  receives,  filters,  and 
stores  information  from  vehicle  appearance  packets  into  PVD  shared  memory.  This  CSC 
detects  and  eliminates  vehicles  that  have  timed  out,  and  accesses  basic  network  services. 

This  CSC  is  designed  to  hide  the  details  of  networic  communications  from  other  CSC 
functions.  This  CSC  functionality  is  broken  down  into  the  lower-level  CSCs  shown  in 
Figure  2-6. 


Figure  2-6:  Network  Processing  CSC  Structure. 
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2.6.1  Initial  Network  Process  CSC  Description 
This  CSC  provides  the  main  entry  for  network  processing. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.6. 1-1. 


Figure  2.6.1-1:  Network  Processing — Initial  Network  Process 

CSC  Structure. 

2.6. 1.1  virtual_net.c 

This  CSU  involves  a  network  interface.  It  contains  functions  that  initialize  and  receive 
packets  from  the  simulation  network  via  the  association  layer  (libassoc.a.) 


Table  2.6.1. 1-1:  Function  Summary  -  init_virtual_net() 
This  function  initializes  a  connection  to  the  network  through  the  association  layer. 
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Table  2.6.1.1-2:  Function  Summary  -  get  next_packet(buf_ptr,  length, 

group,  protocol,  ori^nator) 

This  function  gets  the  next  packet  from  the  association  layer. 
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2.6.2  Send  Packets  CSC  Description 

This  CSC  initializes  and  sends  packets  based  on  menu  selections. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.6.2- 1. 

Send 

Packets 

3.6.2 


intem_ 
send.c 
3.6.2. 1 


Figure  2.6.2>1:  Network  Processing»Send  Packets  CSC  Structure. 


2. 6. 2.1  intern_send.c 

This  eSU  contains  routines  for  simulating  sending  packets  to  oneself. 


Table  2.6.2.1-1:  Function  Summary  •  fake_deactivate(  vehicle_id  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vehicle  id 

int 

standard 

Cal 

Is 

Function 

Where  Described 

aet  world  state 

tank  number  exists 
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Table  2.6.2.1-2:  Function  Summary  -  init_internal_ring_buffers() 


1  Calls  1 

Function 

Where  Described 

initialize  pir  array 

Table  2.6.2.1-3:  Function  Summary  -  send_buffer_to_self(  net_buffer  ) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

net  buffer 

pointer  to  NetworkBuffer 

network.h 

Ca 

Is 

Function 

Where  Described 

fake  filter 

this  file 

enqueue  buffer  into  fake  rinq 

this  file 

Table  2.6.2.1-4:  Function  Summary  -  fake_filter(  buffer  ) 

Fake  filter  simulates  the  effect  of  CMC  crad  filtering  on  exercise  ID  for  those  buffers  which 
come  from  some  other  source  than  the  network  (e.g.,  the  internal  CATC  functions.) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

buffer 

pointer  to  NetworkBuffer 

network.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

1 

int 

accept  all  packets  in  this  mode 

0 

int 

accept  all  non-Sim  packets 

1  Calls  1 

Function 

Where  Described 

qet  exercise 

Pvd  misc.c 

Table  2.6.2.1-5:  Function  Summary  -  enqueue_buffer_into_fake_ring 

(  buffer  ) 


This  function  copies  buffer  into  a  fake  ring  buffer  for  later  processing. 


1_ lint_ I  otherwise 
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Table  2.6.2. 1-6:  Function  Summary  -  process_internal_ring_buffer() 
This  function  processes  buffers  form  the  internal  ring  buffer. 


Calls _ 

Function  I  Where  Described 

CollectWorldState  I  Pvd_misc  c 

pet  world  state  I  ~ 


2.6.3  Filter  Packets  CSC  Description 

This  CSC  receives  and  filters  packets  based  on  menu  selections. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.6.3- 1. 

Filter 

Packets 

3.6.3 


coltision.c 

3.6.3.1 


Figure  2.6.3- 1:  Network  Processing-Filter  Packets  CSC  Structure. 
2.6.3. 1  collision.c 

This  CSU  handler  collision  PDUs.  When  a  collision  occurs,  it  displays  information  in  the 
event  window,  such  as  the  vehicle  IDs  of  the  involved  vehicles. 


Table  2.6..3.1-1:  Function  Summary  •  do_coliision(  coll_variant  ) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

coll  variant 

pointer  to  CollisionVariant 

p  sim.h 
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1  Calls  1 

Function 

Where  Described 

??et  text  window 

T  windows.c 

print  vehicle  id 

Pvd.misc.c 

2.6.4  Store  CSC  Description 

This  CSC  stores  status  information  in  shared  memory. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.6.4- 1. 
Additionally,  this  CSC  makes  use  of  the  CSU,  libshm.a  (Section  2.4.3.3),  and 
pvd_misc.c.  (Section  2.6.5. 1). 


Store 

3.6.4 


hash_fn.c 

3.6.4.1 

libtabie.a 

3.6.4.2 


Figure  2.6.4-1:  Network  Processing— Store  CSC  Structure. 


2.6.4. 1  hash_fn.c 

This  CSU  executes  the  hash  function  used  in  the  tabling  code.  It  stores  the  numbers  used 
to  access  vehicle  appearance  packets. 
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Table  2.6.4.1-1:  Function  Summary  •  Hash_Vehicle_ID(  vehicle_id  ) 


Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

vehiclejd 

pointer  to  register  unsigned 
short 

standard 

Return  Values 


Return  Value 


index 


Meanin 


index  to  hash  table 


Table  2.6.4.1-2:  Function  Summary  •  matching_vehicle_IDs 

(  vehicle_id,  pdu  )  ~  ~ 


Parameter 


vehicle  id 


du 


Parameters 


e 


inter  to  vehiclelD 


inter  to  SimulationPDU 


Where  Tvpedef  Declared 


basic.h 


sim.h 


Return  Value 


eaual  vehicle  IDs 


Return  Values 


Meanin 


vehiclelDs  are  eaual 


1  Calls 

Function 

Where  Described 

eaual  vehicle  IDs 

this  file 

Table  2.6.4.1>3:  Function  Summary  •  equal_vehicle_IDs 
(  vehicle_idl,  vehicle_id2)  ” 


Parameter 


vehicle  idl 


vehicle  id2 


Parameters 


e 


inter  to  VehiclelD 


inter  to  VehiclelD 


Where  Tvpedef  Declared 


basic.h 


basic.h 


Return  Value 


1 


Return  Values 


Meanin 


assed  vehiclelDs  are  eaual 


other 


Table  2.6.4.1>4:  Function  Summary  •  get_vehicle_index(  id  ) 

This  function  returns  the  vehicle  index  corresponding  to  the  passed  vehicle  id.  It  returns  -1 
if  there  is  no  such  vehicle. 


Parameter 


id 


Parameters 


e  Where  Tvpedef  Declared 


inter  to  reaister  VehiclelD  basic.h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

table_entry 

int 

vehicle  index  corresponding  to 
passed  vehicle  id 

-1 

int 

no  such  vehicle 

Calls 

Function  I  Where  Described 

Hash  Vehicle  ID  |  this  file 

table  get  I 


2. 6. 4. 2  libtable.a 

This  is  a  common  library  shared  by  PVD  and  other  SIMNET  applications. 


2.6.5  Other  Packets  CSC  Description 

This  CSC  routes  filtered  packets  to  other  CSC  functions. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.6.5- 1. 

Other 

Packets 

3.6.5 


pvd_misc.c 
3.6.5. 1 


Figure  2.6.5- 1:  Network  Processing— Other  Packets  CSC  Structure. 


) 
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2.6.5. 1  pvd_niisc.c 

This  CSU  stores  status  packets,  and  dispatches  functions  to  handle  the  various  other  PDUs 
relevant  to  the  PVD.  The  key  function  in  this  file  is  Collect_World_State. 

Table  2.6.5.1-1:  Function  Summary  -  ColIect_World_State(  buf,  length, 
group,  protocol,  originator,  world_state  ) 


Parameters 


Parameter 


buf 


lenath 


rotocol 


onamator 


world  state 


MultiCastGroupID 


AssodationUserProtocol 


Where  Tvoedef  Declared 


standard 


standard 


assoc.h 


assoc.h 


inter  to  SirmjIationAddress  address. h 


pointer  to  register  stoict 
WORLD  STATE 


world  state,  h 


Calls  j 

Function 

Where  Described 

construct  sim  from  stealth 

Place.c 

matching  vehicle  IDs 

Hash  fn.c 

lint  simulation  address 


current  exercise 


Hash  Vehicle  ID 


table  aet 


lint  vehicle  id 


make  new  vehicle  index 


PRO  SIM  APPEARANCE  SIZE 


table  insert 


net  aettime 


create  icon 


do  imoact 


do  direct  fire 


do  collision 


et  vehicle  index 


urge  vehicle 


rocess  minefield  marker  odu 


rocess  breached  lane  odu 


rocess  minefield 


nnt  data  header 


display  status  change 


modify  last  status  packet 


lase 


display  event  fla 


handle  terrainorotocol 


handle  log  rtc 


handle  stealth  error 


handle  attached  packet 


this  file 


this  file 


this  file 


this  file 


ibnetif.a  in  MCC  CSC! 


Dir  fire.c 


Indir  fire.c 


Collision.c 


Hash  fn.c 


Purge.c 


Stat  change.c 


Pvd  misc.c 


Lase.c 


Pvd  misc.c 


Pvd  rtc.c 


Place.c 


Place.c 
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Table  2.6.5.1-2:  Function  Summary  -  UpdateText_DispIay(  world_state  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

world_state 

pointer  to  struct 

WORLD  STATE 

woi1d_state.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

Text  Display 

int 

value  of  world  state 

Table  2.6.5.1*3:  Function  Summary  •  out_of_range(  index,  bound  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

index 

int 

standard 

bound 

int 

standard 

1  Return  Values  1 

Return  Value 

Meaning 

1 

int 

passed  array  index  is  outside 
the  specified  bounds 

-1 

int 

0  to  bound 

0 

int 

othenvise 

Table  2.6.5.1*4:  Function  Summary  - 

init_ascii() 

This  function  sets  up  an  ASCII  terminal. 

I  Calls  I 

Function 

1  Where  Described  1 

clear  screen 

Text.c 

home 

Text.c 

Table  2.6.5.1-5:  Function  Summary  -  make_new_vehicle_index() 
This  function  is  called  only  when  a  new  vehicle  is  being  created. 
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Table  2.6.5.1-6: 


Function  Summary  -  refresh_timestamps() 


This  function  sets  the  time  of  the  last  packet  received  for  all  existing  tanks  tothe  current 
time.  For  example,  it  is  used  after  updates  have  been  turned  off  during  a  logger  freeze. 


1  Calls  1 

1  Function 

I  Where  Described  1 

1  aet  world  state  I  I 

1  net  aettime 

I  ibnetif.a  in  MCC  CSCI  1 

Table  2.6.5.1-7:  Function  Summary  -  clear_net_input() 

This  function  marks  all  routines  for  erasure  and  clears  buffers  of  packets  waiting  for 
processing. 


1  Calls  1 

1  Function 

!  Where  Described  1 

1  qet  world  state  i  I 

1  net  flush 

t  ibnetif.a  in  MCC  CSCI 

Table  2.6.5.1*8:  Function  Summary  •  spin() 


This  function  wastes  cycles,  for  example,  while  waiting  for  the  CMC  card  to  clear  a  flag  in 
shared  memory. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

dilatory  -  dilatory 

int 

wastes  time 

Table  2.6.5.1.9: 

Function  Summary  -  get_spin_count() 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

spin  count 

int 

number  of  times  spin  was  called 

Table  2.6.5.1-10: 

Function  Summary  -  init_text_exercises() 

This  function  sets  up  the  card  to  read  all  exercises. 

1  Calls  1 

Function 

Where  Described 

AssocSubscribe 

ibassoc.a  in  MCC  CSCI 
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Table  2.6.5.1-11: 


Function  Summary  -  set_exercise(  exercise_id  ) 


This  function  sets  the  exercise  ID  to  be  viewed.  Valid  ID  numbers  are  1  to  255. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

exercise  id 

int 

standard 

Ca 

is 

Function 

Where  Described 

AssocUnsubscribe 

Protocol 

AssocSubscribe 

Protocol 

set  stealth  exercise 

clear  net  input 

Pvd  misc.c 

Table  2.6.5.1-12:  Function  Summary  -  current_exercise(  exercise_id  ) 

This  function  returns  1  if  the  passed  exercise  ID  is  acceptable,  given  what  exercises  are 
being  accepted. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

exercise  id 

int 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Exercise  ID  not  current  exercise 

1 

int 

Exercise  ID  =  current  exercise 

Table  2.6.5.1-13:  Function  Summary  -get_exercise() 
This  function  returns  the  exercise  currently  being  displayed. 


I  Return  Values  I 

Return  Value 

Type 

Meaning 

CURRENT  exercise 

int 

pointer  to  CURRENT  exercise 

Table  2.6.5.1-14:  Function  Summary  -  get_vehicle_exercise(  vehicle_id  ) 
This  function  assumes  vehiclejd  is  valid.  Given  a  valid  id,  it  returns  the  exercise. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vehicle  id 

pointer  to  VehiclelD 

basic.h 
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Table  2.6.5.1-15:  Function  Summary  -  get_dynamic_appearance_data 
(vehicle_index,  guises,  appearance,  location,  'velocity  ) 


This  function  fills  in  data  for  key  changing  components  of  an  tq)pearance  packet. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vehicle  index 

int 

standard 

Quises 

Pointer  to  VehicieGuises 

basic.h 

appearance 

Pointer  to  unsianed  Iona 

standard 

location 

Pointer  to  float 

standard 

velocity 

Pointer  to  float 

standard 

1  Calls  1 

Function 

Where  Described 

qet  world  state 

Table  2.6.5.1-16:  Function  Summary  -  print_vehicle_id(  vehicle_id  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vehicle  id 

Pointer  to  VehiclelD 

basic.h 

1  Calls  1 

Function 

Where  Described 

fprint  vehicle  id 

this  file 

Table  2.6.5.1-17:  Function  Summary  -  fprint_vehicle_id(  fd,  vehicle_id  ) 
This  function  prints  the  vehicle  id. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fd 

Pointer  to  FILE 

stdio.h 

vehicle  id 

Pointer  to  VehiclelD 

basic.h 
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Table  2.6.5.1-18:  Function  Summary  -  print_simulation_address 

(simulation_address  )  ~ 

This  function  calls  fiprint_simulation_address. 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

simulation  address 

Pointer  to  SimulationAddress 

address,  h 

1  Calls  1 

Function 

Where  Described 

fprint  simulation  address 

this  file 

Table  2.6.5.1-19:  Function  Summary  -  fprint_simulation_address 

(  fd,  simulation  address  )  ~ 


This  function  prints  the  Site  name  and  Host  name. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

fd 

Pointer  to  FILE 

stdio.h 

simulation  address 

Pointer  to  SimulationAddress 

address. h 

1  Calls  1 

Function 

Where  Described 

set  text  window 

T  windows.c 

print  vehicle  id 

this  file 

Table  2.6.5.1-21:  Function  Summary  -  modify_last_status_packet 

(status_change  ) 


This  function  updates  the  last  status  packet  for  the  vehicle  to  account  fra:  the  change  in 
status  reported  by  the  passed  Status  Change  PDU. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

status_change 

Pointer  to 

StatusChanqeVarjant 

p_data.h 

Table  2.6.5.1-20:  Function  Summary  -  display_event_nag(  e_variant  ) 


This  function  prints  the  data  from  an  event  flag  packet  in  the  event  window. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

e  variant 

Pointer  to  EventFlaaVariant 

p  data.h 
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2.6.6  Purge  CSC  Description 

This  CSC  purges  vehicles  based  on  time  stamp  packet  information. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.6.6- 1. 


Purge 

3.6.6 


purge.c 

3.6.6.1 


Figure  2.6.6-1:  Network  Processing-Purge  CSC  Structure. 


2. 6. 6.1  purge.c 

This  CSU  deletes  all  tanks  that  have  not  broadcast  an  appearance  packet  within  the  time-out 
period.  It  remaps  the  globally  available  list  of  currently  selected  tanks  to  account  for  the 
deletion  of  a  tank.  It  tdso  adjusts  the  list  of  tanks  tagg^  for  vehicle  to  vehicle  intervisibility 
display  to  account  for  evaporation  (due  to  cessation  of  appearance  packets)  of  a  tank. 


Table  2.6.6.1-1:  Function  Summary  -  remap_selected_tanks(  dead_id  ) 

This  function  remaps  the  globally  available  linked  list  of  currently  selected  tanks  to  account 
for  the  deletion  of  a  tank  BD. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

dead  id 

int 

standard 
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Table  2.6.6.1-2: 


Function  Summary  -  remap_tagged_tanks(  dead_id  ) 


This  function  adjusts  the  list  of  tanks  tagged  for  vehicle-to-vehicle  intervisibility  display  to 
account  for  the  evaporation  of  a  tank  due  to  the  cessation  of  appearance  packets. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

dead  id 

int 

standard 

1  Calls  1 

Function 

Where  Described 

oet  taas 

Vehicle  to  v.c 

erase  ravs 

Vehicle  to  v.c 

set  taas 

Vehicle  to  v.c 

Table  2.6.6.1-3:  Function  Summary  -  purge_expired_vehicles(  time  ) 

This  function  updates  the  timestamps  on  all  vehicles  and  purges  any  vehicles  that  have  not 
received  an  appearance  packet  within  the  time-out  period. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

time 

int 

standard 

1  Calls  1 

Function 

Where  Described 

get  world  state 

print  vehicle  id 

Pvd  misc.c 

purge  vehicle 

this  file 

Table  2.6.6.1-4:  Function  Summary  -  set_time_out_msec(  milli_sec  ) 

This  function  determines  the  number  of  milliseconds  before  a  vehicle  times  out.  This 
shouldormally  be  set  to  protocolVehicleDisappearanceTime  ♦  1000. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

milli  sec 

int 

standard 

Table  2.6.6. 1-5:  Function  Summary  -  purge_vehicle(  vehicle_index  ) 
This  function  eliminates  a  vehicle  that  has  timed  out  ot  has  been  deactivated. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

vehicle  index 

int 

standard 
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Ca 

Is 

Function 

Where  Described 

get  world  state 

table  delete 

print  vehicle  id 

Pvd  misc.c 

spin 

this  file 

table  free 

delete  icon 

Icon.c 

remap  selected  tanks 

this  file 

remap  tagged  tanks 

this  file 

delete  text  tank 

Text.c 

delete  vehicle  id 

2.6.7  Protocol  Definitions  CSC  Description 

This  CSC  provides  network  protocol  definitions. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.6.7- 1. 

Protocol 

Defs. 

3.6.7 

network,  h 

3.6.7.1 

Iibp2p.a 

3.6.7.2 


Figure  2.6.7-1:  Network  Processing — Protocol  Definitions  CSC  Structure. 
2.6.7.I.  network.h 

This  is  a  commonly-maintained  file  containing  network  protocol  definitions  used  by  Plan 
View  Display  and  other  SIMNET  applications. 

2. 6. 7. 2  Iibp2p.a 

This  is  a  common  library  shared  by  PVD  and  other  SIMNET  applications. 
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2.7 


GRAPHICS  CSC  DESCRIPTION 


This  CSC  provides  graphics  support  for  graphics  input  and  display. 


This  CSC  functionality  is  broken  down  into  the  CSCs  shown  in  Figure  2-7. 


Figure  2-7:  Graphics  CSC  Structure. 
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2.7.1  Initial  Graphics 
This  CSC  initializes  graphics  support. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.7.1-1. 

Initial 

Graphics 

3.7.1 


initjcmap.c 

3.7.1. 1 


init _jgraph.c 

3.7.2.1 


Figure  2.7.1-1:  Graphics»Initial  Graphics  CSC  Structure. 


2. 7. 1.1  init_cmap.c 

This  CSU  initializes  the  terrain  color  map.  There  are  15  color  slots  to  assign;  black  is 
hardwired. 


Table  2.7.1.1-1;  Function  Summary  -  fIag_map_coIors() 
This  function  initializes  the  map_colors. 

Table  2.7.1.1-2:  Function  Summary  •  init_terrain_cmap(  shift  ) 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

shift 

int 

standard 

1  Calls  1 

1  Function 

1  Where  Described  1 

mafcns 

Concurrent  araphics  library 

make  color  mao 

Color  map.c 
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Table  2.7.1.1-3:  Function  Summary  'mapcoIorC  index,  red,  green,  blue, 

shift  ) 


Parameters 


Parameter 


index 


red,  green,  blue 


shift 


Where  Typedef  Declared 


standard 


standard 


standard 


Function 


Calls 


Where  Described 


2.7. 1.2  init_graph.c 

This  CSU  initializes  Plan  View  Display  on  a  graphics  terminal. 

Table  2.7.1.2-1:  Function  Summary  -  init_graph() 


This  function  initializes  Plan  View  Display  on  a  graphics  terminal. 


Ca 

Is 

Function 

Where  Described 

mgiasngp 

Concurrent  graphics  library  subroutine 

mgiexitmode 

Concurrent  graphics  library  subroutine 

mgiclearpin 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

1  mgidefw  I 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

count  bits  set 

Finite  zoom.c 

get  shift 

Finite  zoom.c 

init  paint  system 

new  zoom.c 

init  working  cursor 

Pvd  iface.c 

mgifb 

Concurrent  graphics  library  subroutine 

mgisyncrb 

Concurrent  graphics  library  subroutine 

mgiocm 

Concurrent  graphics  library  subroutine 

init  terrain  cmap 

Init  cmap.c 

rob 

Rgb.c 

make  color  map 

Color  map.c 

init  window  colors 

init  windows.c 

init  icon  colors 

Icon.c 

mgrvcoor 

Concurrent  graphics  library  subroutine 

init  pixel  map  descriptors 

New  zoom.c 

init  user  interface 

Pvd  iface.c 

init  working  cursor 

Pvd  iface.c 

init  icons 

Icon.c 

(Table  2.7.1 .2-1  is  continued  on  the  following  page.) 
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Function 

Where  Described 

init  bursts 

indir  fire.c 

init  effects 

effects.c 

toaqle  shade 

Unshade.c 

display  top  map 

Display  top.c 

add  view 

Prev  view.c 

init  workinq  cursor 

Pvd  iface.c 

init  POPUP 

Pop  windows.c 

init  discrete  zoom 

Finite  zoom.c 

init  cursor 

Pvd  iface.c 

2.7.2  Graphics  Display  Support 
This  CSC  supports  graphics  display. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.7.2- 1. 


Graphics  Display 

Support 

3.7.2 


color_map.c 

3.7.2.1 


highlight.c 

3.7.2.2 

rgb.c 

3.7.2.3 


Figure  2.7.2-1:  Graphics— Graphics  Display  Support  CSC  Structure. 
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2.7.2. 1  color_map.c 

This  CSU  contains  routines  for  creating  the  colcff  map  for  Plan  View  Display,  including 
overlaying  graphics  windows  and  addmg  tank  icons,  trails,  contour  lines,  and  terrain. 


Table  2.7.2.1-1:  Function  Summary  -  make_color_map(  plane_mask, 

RGBvais  ) 

This  routine  determines  which  type  of  entry — ^icons,  contour  lines,  or  terrain — ^is  being 
made  to  the  color  map. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

plane  mask 

int 

standard 

RGBvais 

Iona 

standard 

Ca 

Is 

Function 

Where  Described 

make  terrain  colors 

this  file 

make  contour  colors 

this  file 

make  icon  colors 

this  file 

make  window  colors 

this  file 

Table  2.7.2.1.2: 


Function  Summary  •  make_window_coIors(  RGBvais  ) 


This  function  assigns  the  passed  window  colors  to  the  lower  two  planes  of  the  color  map. 
Color  OOB  is  always  transparent. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

RGBvais 

Iona 

standard 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  araphics  library 

Table  2.7.2.1>3:  Function  Summary  •  make_icon_colors(  RGBvais  ) 

This  function  assigns  all  entries  with  lower  two  bits  equal  to  OOB  (i.e.,  transparent)  and 
those  with  the  next  three  bits  not  equal  to  OOOB. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

RGBvais 

Iona 

standard 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  araphics  library 
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Table  2.7.2.1-4:  Function  Summary  •  make_terrain_colors(  RGBvals  ) 

This  function  assigns  all  the  entries  of  the  coIot  map  with  the  correct  upper  four  bits  to  the 
color  specified  by  the  RGBvals  entry.  The  entry  has  the  lower  six  bits  as  OOOOOOB. 
Otherwise  the  colors  speciried  by  the  lower  six  bits  will  prevail. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

RGBvals 

Iona 

standard 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  araohics  Ubrarv 

Table  2.7.2.1-5: 

Function  Summary  •  make_contour_colors(  RGBvals  ) 

This  function  assigns  all  the  entries  of  the  color  map  with  the  lower  five  bits  set  to  OOOOOB 
and  the  sixth  bit  set  to  1  to  the  color  specified  by  the  RGBvals  entry.  The  entry  with  the 
lower  six  bits  as  OOOOOOB  allows  control  to  go  to  the  upper  four  bits.  Otherwise,  the 
colors  specified  by  the  lower  six  bits  will  prevail. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

RGBvals 

Iona 

standard 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  araohics  library 

2.7. 2.2  highlight.c  CSU  Description  (/simnet/pvd/lib/pvdiface.a) 
This  CSU  highlights  the  selected  tank  icon. 


Table  2.7.2.2*1:  Function  Summary  •  highlight_tank(  index  ) 
This  function  prints  the  tank  index  to  be  highlighted. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

standard 

Ca 

Is 

Function 

Where  Described 

hiahliaht  selected  icon 

Icon.c 
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Table  2.7.2.2-2; 


Function  Summary  -  unhighlight_tank(  index  ) 


This  function  prints  the  tank  index  to  be  unselected. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

standard 

1  Calls  1 

Function 

Where  Described 

unhiohlight  selected  icon 

Icon.c 

2. 7. 2. 3  rgb.c 

This  CSU  converts  4  bit  (0  to  15)  RGB  color  intensities  into  values  suitable  for  insertion 
into  a  color  map. 


Table  2.7.2.3-1:  Function  Summary  -  rgb(  red,  green,  blue  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

red,  green,  blue 

int 

standard 

Return  Values 


Return  Value 


Type 


Meaning 


color  map  entry 


int 


32-bit  integer  value 
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2.8  OVERLAYS  CSC  DESCRIPTION 

This  CSC  provides  for  the  creation  of  map  overlays,  consisting  of  militaty  unit  symbols, 
free  draw  objects,  and  control  points.  This  CSC  iso  provides  menu  options  for  specifying 
these  map  features — contour,  pan,  zoom,  and  grid.  1  his  CSC  supports  saving  and 
retrieving  overlays  in  files. 

This  CSC  functionality  is  broken  down  into  lower-level  CSCs  shown  in  Figure  2-8. 


Figure  2-8:  Overlays  CSC  Structure. 
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2.8.1  Initial  Overlays  CSC  Description 
This  CSC  provides  the  main  entry  for  Overlays. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.8. 1-1. 

Initial 

Overlays 

3.8.1 


overlayif.c 

3.8.1. 1 

r>ew_ 

overlay.c 

3.8.1. 2 

Figure  2.8.1-1:  Overlays— Initial  Overlays  CSC  Structure. 
2.8. 1.1  overlayrf.c 

This  CSU  contains  routines  that  handle  common  overlay  menu  functions. 


Table  2.8.1. 1-1:  overlay_niouse() 

This  function  handles  mouse  events  while  the  PVD  is  in  Overlay  Mode.  The  right  button 
chooses  a  menu  option;  the  center  button  selects  an  object ;  and  the  left  button  prints 
information  about  an  object. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

1 

int 

OverlaysOn 

1  Ca 

Is 

[  Function 

Where  Described 

nandle  menu 

Menu.c 

select  overobi 

This  file 

select  region 
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Table  2.8.1.1>2:  Function  Summary  -  zoom_overlay() 


This  function  redraws  everything  that  was  created  through  the  Overlays  Menu  and  is  now 
included  in  the  Overlay  Table. 


Function 


et  shift 


calc  zoom  ratio 


zoom  overline 


zoom  controlpt 


zoom  symbol 


Calls 


Where  Described 


Finite  zoom.c 


New  overlav.c 


Overline.c 


Controlot.c 


svmbol.c 


Table  2.8.1. 1-3:  Function  Summary  -  erase_overlay() 

This  function  erases  all  the  items  cumendy  active  in  the  object  tables.  It  does  not  clear  the 
object  tables. 


Calls 

Function 

Where  Described 

calc  zoom  ratio 

New  overlav.c 

erase  overline 

Overline.c 

erase  controlpt 

Controlot.c 

erase  symbol 

svmbol.c 

rrsi 


init  workino  cursor 


unified  oaint  square  reoion 


init  cursor 


Concurrent  oraphics  library  subroutine 


Pvd  iface.c 


New  zoom.c 


Pvd  iface.c 


Table  2.8.1.1-4:  Function  Summary  -  read_over() 
This  function  loads  and  displays  an  overlay  in  the  permanent  set  of  planes. 


Function 


et  overla 


draw  overlay  menu 


Calls 


Where  Described 


this  file 


this  file 


Menu.c 


Table  2.8.1. 1-5:  Function  Summary  -  get_overlay() 

This  function  prompts  the  user  for  a  file,  then  loads  and  displays  the  overlay  objects 
contained  in  that  file. 


Function 


load  overla 


Calls 


Where  Described 


Over  files  c 


This  file 
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Table  2.8.1.1-6:  Function  Summary  -  save^overQ 
This  function  saves  the  current  overlay. 


Cal 

IS 

Function 

Where  Described 

get  typed  input  str 

interact.c 

save  overline 

Over  files.c 

save  controlpt 

Over  files.c 

save  symbol 

Over  files.c 

Table  2.8. 1.1-7:  Function  Summary  -  delete_over_file() 
This  function  deletes  overlay  files. 

Table  2.8.1. 1-8:  Function  Summary  -  edit_over() 


This  function  loads  and  displays  an  overlay  in  the  EDIT  set  of  planes. 


1  Calls  1 

1  Function 

Where  Described 

■  III! . . 

This  file 

this  file 

1  draw  overlay  menu 

menu.c 

Table  2.8.1.1-9:  Function  Summary  •  reset_overlay() 

This  function  erases  all  the  items  currently  active  in  the  object  tables  and  clears  the  object 
tables. 


Calls  1 

Function 

Where  Described 

calc  zoom  ratio 

New  overlay.c 

erase  overline 

Overline.c 

erase  controlpt 

Controlpt.c 

erase  symbol 

symbol.c 

clear  overlays 

New  overfay.c 

IS? 


nrsj 


init  working  cursor 


unified joaint  square  region 


init  cursor 


Concurrent  graphics  library  subroutine 


Pvd  iface.c 


New  zoom.c 


Pvd  iface.c 
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Table  2.8.1.1>10:  Function  Summary  •  select_overobj() 

This  function  tries  to  select  the  object  currently  pointed  at  by  the  mouse.  It  first  checks  for 
unit  symbols,  then  for  free  draw  lines,  and  finally  for  control  points.  This  ordering  affects 
selection  of  overlapping  objects,  i.e.,  it  is  possible  NOT  to  select  an  object  due  to  Ae 
proximity  of  higher  priority  objects. 


Cal 

Is 

Function 

Where  Described 

uncolor  selected 

symbolif.c 

uncolor  controlpt 

Controlptif.c 

select  overline 

Overtineif.c 

select  controlpt 

Controlptif.c 

strino  error  box 

Error  box.c 

kill  error  window 

Error  box.c 

Table  2.8.1.1-11:  Function  Summary  -  delete_overobj() 
This  function  deletes  overlay  objects. 


Cal 

Is 

Function 

Where  Described 

controlpt  delete 

Controlptif.c 

overline  delete 

Overtineif.c 

symbol  delete 

Symbolif.c 

Table  2.8.1.1-12:  Function  Summary  •  reduce_overobj() 


This  function  resizes  selected  overlay  objects. 


1  Calls  1 

Function 

Where  Described 

controlpt  reduce 

Controlptif.c 

symbol  reduce 

Symbolif.c 

Table  2.8.1.1-13: 

Function  Summary  -  move_overobj() 

This  function  moves  selected  overlay  objects. 

1  Calls  1 

Function 

Where  Described 

move  controlpt 

Controlptif.c 

symbol  move 

Symbolif.c 

BBN  Systems  and  Technologies 


Plan  View  Display  CSO 


Table  2.8.1.1-14: 


Function  Summary  -  addtext_overobj() 


This  function  adds  text  to  a  selected  overlay  object. 


1  Calls  1 

Function 

Where  Described 

controlpt  addtext 

Controlptif.c 

overline  addtext 

Overlineif.c 

symbol  addtext 

Symbolif.c 

Table  2.8.1.1-15: 

Function  Summary  -  init_erasing_cursor() 

This  function  changes  the  cursor  into  a  unified  square. 

1  Calls  1 

Function 

Where  Described 

mailoadcurs 

Concurrent  oraphics  library 

Table  2.8.1.1-16:  Function  Summary  -  init_drawing_cursor() 
This  function  changes  the  cursor  into  a  solid  box. 


1  Calls  1 

Function 

Where  Described 

mgiloadcurs 

Concurrent  oraphics  library  subroutine 

Table  2.8.1.1-17:  Function  Summary  -  init_size_cursor() 
This  function  changes  the  cursor  into  a  small  filled  square. 


1  Calls  1 

Function 

Where  Described 

mgiloadcurs 

Concurrent  graphics  library 

Table  2.8.1.1-18:  Function  Summary  -  gen_add_text(  Text,  Window, 

Planes,  Hue) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Text 

pointer  to  SYMLABEL 

symbol,  h 

Window 

int 

standard 

Planes 

int 

standard 

Hue 

int 

standard 
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Ca 

Is 

Function 

Where  Described 

Concurrent  qraphics  Kbrary  subroutine 

Concurrent  qraphics  library  subroutine 

maihue 

Concurrent  qraphics  library  subroutine 

add  free  text 

Overdraw.c 

oet  strinq 

this  file 

mgiqetcursmode 

Concurrent  qraphics  library  subroutine 

maicursmode 

Concurrent  qraphics  library  subroutine 

display  cursor  loc 

maimodfunc 

Concurrent  qraphics  library  subroutine 

move  mouse  help 

Concurrent  qraphics  library  subroutine 

pixel  to  user 

Pvd  Iface.c 

default  mouse  help 

Pvd  windows.c 

Table  2.8.1.1-19:  Function  Summary  -  get_string(  Strinput  ) 

This  routine  displays  a  prompt  for  the  user  to  input  a  string  which  is  then  stored  in 
Strinput. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Strinput 

pointer  to  char 

standard 

2.8. 1.2  new_overlay.c  CSU  Description  (/simnet/pvd/Iib/liboverlay.a) 
This  CSU  contains  routines  that  handle  common  overlay  functions. 

Table  2.8.1.2-1:  Function  Summary  -  overIay_init() 

This  routine  initializes  all  overlay  tables. 


Calls 

Function 

Where  Described 

symbol  init 

symbol.c 

overline  init 

Overline.c 

controlpt  init 

Controlpt  .c 

init  over  files 

Over  files.c 
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Table  2.8.1.2-2:  Function  Summary  -  display_overlays(  Planes, 
PencilHue,  FoeHue,  FriendHue,  ClearHue  ) 

This  routine  redraws  everything  that  was  created  through  the  OVERLAYS  menu  and  is 
now  included  in  the  Overlay  Table. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Planes 

int 

standard 

PencilHue 

int 

standard 

FoeHue 

int 

standard 

FriendHue 

int 

standard 

ClearHue 

int 

standard 

Ca 

Is 

Function 

Where  Described 

calc  zoom  ratio 

this  file 

zoom  overline 

Overline.c 

zoom  controlot 

Controlot  c 

zoom  symbol 

svmbol.c 

Table  2.8.1.2>3:  Function  Summary  •  clear_overlays() 


This  routine  clears  the  contents  of  the  Overlay  Tables. 


1  Calls  i 

Function 

Where  Described 

overline  reset 

Overline.c 

controlot  reset 

Controlot  c 

symbol  reset 

svmbol.c 

Table  2.8. 1.2-4: 

Function  Summary  -  calc_zoom_ratio() 

This  function  is  called  when  symbols  are  about  to  be  drawn  onto  the  ICON_PLANES. 

1  Calls  1 

Function 

Where  Described 

maraetvcoor 

Concurrent  oraohics  library  subroutine 

maiaetvcoor 

Concurrent  oraohics  library  subroutine 

Table  2.8.1.2-5:  Function  Summary  -  over_user_to_pixel(  px,  py,  rx,  ry  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

px,  py _ 

1  oointer  to  int  1 

standard 
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Function 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Table  2.8. 1.2-6:  Function  Summary  -  over_point_in_box(  x,  y,  box  ) 


BBN  Systems  and  Technologies 


2.8.2  Line  Draw  CSC  Description 

This  CSC  supports  free  drawing  options  for  use  with  lines  and  boundaries  such  as  phase 
lines  and  defended  areas. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.8.2- 1. 


Figure  2.8.2-1:  Overlays— Line  Draw  CSC  Structure. 

2.8.2. 1  overlineif.c 

This  CSU  contains  high-level  functions  that  call  routines  for  displaying  the  popup  window 
and  managing  the  menu  choices  for  free  drawing. 
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Table  2.8.2.1-1:  Function  Summary  -  overline_create(  ) 
This  function  displays  the  pop_window  for  creating  an  overline. 


Cal 

Is 

Function 

Where  Described 

mouse  to  option 

option.c 

del  line  window 

this  file 

draw  line  window 

this  file 

Concurrent  araphics  library  subroutine 

Concurrent  Graphics  library  subroutine 

display  block 

option.c 

maihue 

Concurrent  graphics  library  subroutine 

mark  box 

option.c 

phase  action 

oviine  func.c 

solid  action 

oviine  func.c 

handle  popup  windows 

pop  windows. c 

init  drawina  cursor 

Overlayif.c 

freedraw  mouse  help 

Pvd  windows.c 

calc  zoom  ratio 

New  overlay.c 

display  cursor  loc 

mqiqetvcoor 

Concurrent  graphics  library  subroutine 

overline  loop 

this  file 

insert  overline 

Overline.c 

overline  features 

Overdraw.c 

size  loop 

this  file 

init  cursor 

Pvd  if  ace.  c 

Table  2.8.2.1-2:  Function  Summary  -  overline_addtext(  ) 
This  function  allows  the  user  to  place  a  string  bound  to  a  particular  overline. 


Cal 

Is 

Function 

Where  Described 

gen  add  text 

Overlayif.c 

default  mouse  help 

Pvd  windows.c 

uncolor  line 

this  file 

draw  overline 

Overdraw.c 

1 1  |[  I  1  1  1 1 1  — — — 

Overlayif.c 

Table  2.8.2.1-3:  Function  Summary  -  size_loop(Overline) 


This  function  lets  the  user  place  a  size  icon  on  a  displayed  line. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 
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Table  2.8.2.1-4:  Function  Summary  -  oveline_delete() 
This  function  takes  the  selected  line  and  deletes  it 


1  Calls  1 

Function 

Where  Described 

uncolor  line 

this  file 

draw  overline 

Overdraw.c 

Overlayif.c 

Table  2.8.2.1-5:  Function  Summary  -  overline_newfeatures(  ) 


This  function  allows  the  user  to  modify  the  features  of  a  selected  line. 


Ca 

Is 

Function 

Where  Described 

mouse  to  option 

option.c 

del  line  window 

this  file 

aet  free  overline 

Overline.c 

uncolor  line 

this  file 

draw  line  window 

this  file 

maive 

Concurrent  araphics  library 

Concurrent  araphics  library 

display  block 

option.c 

maihue 

Concurrent  araphics  library 

mark  box 

option.c 

show  overline 

this  file 

copy  overline 

Overline.c 

handle  popup  windows 

pop  windows. c 

draw  overline 

Overdraw.c 

size  loop 

this  file 

init  cursor 

Pvd  iface.c 

Overlayif.c 

Table  2.8.2.1-6:  Function  Summary  -  show_overIine(Overline) 
This  function  displays  Overline  in  a  popup  window. 
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Ca 

is 

Function 

Where  Described 

mark  box 

option.c 

draw  name 

this  file 

draw  time 

this  file 

solid  action 

oviine  func.c 

dashed  action 

Oviine  func.c 

Oviine  func.c 

draw  blabelt 

this  file 

draw  blabel2 

this  file 

loeneric  size 

Overline  func.c 

Table  2.8.2. 1*7:  Function  Summary  -  overline_newshape(  ) 
This  function  allows  the  user  to  modify  the  shape  of  a  selected  line. 


Function 


calc  zoom  ratio 


et  free  overlme 


overline 


uncolor  line 


overline  features 


mqihue 


moiwidth 


over  user  to  pixel 


iti 


freedraw  mouse  hel 


overlme  loo 


draw  overline 


init  cursor 


default  mouse  hel 


Calls 


Where  Described 


New  overlav.c 


Overline.c 


Overline.c 


this  file 


Overdraw.c 


Concurrent  oraphics  libra 


Concurrent  oraphics  libra 


New  overlav.c 


Concurrent  oraphics  libra 


Pvd  windows.c 


this  file 


Overdraw.c 


Overlavif.c 


Pdv  iface.c 


Pvd  windows.c 


Table  2.8.2.1<8:  Function  Summary  -  select_overIine(  ) 

This  function  selects  a  displayed  overline  by  placing  the  cursor  at  any  end  point  and 
pressing  the  left  button. 


Return  Values 


Return  Value 


1 


ion 


Meanin 


overlme  selected 


overlme  not  selected 


I  Calls  I 

Function 

Where  Described 

uncolor  line 

this  file 

mouse  to  overline 

Overline.c 

color  line 

Overlineif.c 
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Table  2.8.2.1-9:  Function  Summary  -  overline_loop(Overline) 

This  function  polls  the  position  of  the  mouse.  If  the  variations  in  either  Y  or  X  direction 
are  bigger  than  some  tlu-eshold,  then  a  new  offset  is  recorded. 


Parameter 


Overline 


Parameters 


inter  to  OVERLINE 


Where  Tvoedef  Declared 


overlme.h 


Calls  1 

Function 

Where  Described 

calc  zoom  ratio 

New  overlay.c 

iwidth 


IV 


In 


mit  drawina  cursor 


overline  features 


overline  pencil  on 


init  erasino  cursor 


overline  erase 


default  mouse  hel 


Concurrent  araohics  libra 


Concurrent  oraphics  libra 


Concurrent  Graphics  libra 


if.c 


Overdraw.c 


this  file 


Overlavif.c 


this  file 


Pvd  windows.c 


Table  2.8.2.1*10:  Function  Summary  -  overline_penciI_on(OverIine) 


Parameter 


Overline 


Parameters 


inter  to  OVERLINE 


Where  Tvpedef  Declared 


overlme.h 


Function 


et  anale 


calc  zoom  ratio 


ixel  to  user 


\n 

ii7i!?Tt?rn»fTi7jrr 


over  user  to  pixel 


add  seament 


Calls 


Where  Described 


Overdraw.c 


New  overlay.c 


Pvd  iface.c 


Concurrent  Graphics  libra 


New  overlay.c 


Overdraw.c 


Table  2.8.2.1-11:  Function  Summary  -  overline_erase(Overline) 
This  function  erases  an  overline. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 

1  Calls  1 

Function 

Where  Described 

calc  zoom  ratio 

New  overlay.c 

erase  seoment 

Overdraw.c 

,1111  . . . 

Overlavif.c 
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Table  2.8.2.1>12:  Function  Summary  -  draw_line_window(  ) 
This  functi(Hi  draws  the  pop  window  to  create  and  edit  lines. 


Cal 

Is 

Function 

Where  Described 

create  window 

Pop  windows.c 

line  req  def 

this  tile 

del  line  window 

this  file 

Table  2.8.2.1-13:  Function  Summary  ~  del_line_window(  ) 
This  function  erases  the  pop  window  for  overlines. 

Calls 


Table  2.8.2.1-14:  Function  Summary  -  iine_reg_def(PopWindow) 


This  function  defines  blocks  in  a  LineRegion. 


Table  2.8.2.1-15:  Function  Summary  -  color_linc(Overiine) 


Function 

reset  region 
delete  window 
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Table  2.8.2.1-16:  Function  Summary  -  uncolor_line(Overline) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 

1  Calls  j 

Function 

Where  Described 

draw  overline 

Overdraw.c 

Table  2.8.2.1-17:  Function  Summary  -  draw_name(Overline) 

This  function  places  the  line  label  at  each  end  of  the  overline,  under  the  line.  It  draws 
the  LineRegion  pop  window. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 

1  Calls  1 

1  Function  1 

Where  Described 

Concurrent  oraphics  library 

Concurrent  oraphics  library 

Table  2.8.2.1-18: 


Function  Summary  -  draw_time(Overline) 


This  function  places  the  time  string  which  describes  when  the  line  is  effective. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Oyerline 

pointer  to  OVERLINE 

oyerline. h 

1  Calls  1 

Function 

Where  Described 

Concurrent  oraphics  library 

Concurrent  oraphics  library 

Table  2.8.2.1-19:  Function  Summary  -  draw_line(Overline) 

This  function  draws  the  line  in  the  pop  window,  taking  into  consideration  things  like 
dashed,  thickness,  etc. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 
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Ca 

Us 

Function 

Where  Described 

mqiwiath 

Concurrent  oraphics  library 

moitt 

Concurrent  graphics  library 

Table  2.8.2.1-20:  Function  Summary  -  draw_lsize(Overline) 

This  function  draws  the  unit  size  corresponding  to  the  boundary  after  redrawing  the  line 
under  it. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 

1  Calls  1 

Function 

Where  Described 

room  for  Isize 

this  file 

get  free  symbol 

symbol.c 

calc  basic  dim 

symbol.c 

draw  size 

symdraw.c 

Table  2.8.2.1-21:  Function  Summary  -  room_for_lsize(Overline,  Mode) 


This  function  erases  or  redraws  the  section  of  teh  overline  that  coincides  with  the  size 
icons. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 

Mode 

int 

standard 

1  Calls  1 

Function 

Where  Described 

mgihue 

Concurrent  graphics  library  subroutine 

mgiwidth 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

1  mgidash 

Concurrent  graphics  library  subroutine 

Table  2.8.2.1-22:  Function  Summary  -  draw_ltype(Overiine) 
This  function  makes  the  changes  necessary  to  draw  the  overline  type. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 
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Function 


draw  blabell 


draw  blabel2 


draw  endlabels 


draw  midlabei 


Calls 


Where  Described 


this  file 


this  file 


this  file 


this  file 


Table  2.8.2.1*23:  Function  Summary  -  draw_blabel2 (Overline) 


Parameter 


Overline 


Parameters 


inter  to  OVERLINE 


Where  Tvpedef  Declared 


overline,  h 


Function 


f 


fs 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraDhics  library  subroutine 


Table  2.8.2.1-24:  Function  Summary  -  draw_blabell(Overline) 


Parameter 


Overline 


Parameters 


inter  to  OVERLINE 


Where  Typedef  Declared 


overline.h 


Function 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.8.2.1-25:  Function  Summary  -  draw_endlabels(Overline,  String) 
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Function 


f 


Calls  _ 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


2. 8. 2. 2  ovline_func.c 

This  CSU  contains  routines  included  in  overline  option  blocks. 

Table  2.8.2.2-1:  Function  Summary  -  namejabel 
(LimitX,  Start Y,  StartX,  Tallest) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


Return  Value 


draw  text  label 


Return  Values 


Meanin 


initiates  labelin 


Table  2.8.2.2>2:  Function  Summary  -  name_action  (Region,  Overline) 


Parameter 


Reoion 


Overline 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  OVERLINE  I  overline.h 


Function 


maihue 


mark  box 


draw  name 


et  strin 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


option. c 


Overlineif.c 


Overtayif.c 


Table  2.8.2.2-3:  Function  Summary  -  timejabel 
(LimitX,  StartY,  StartX,  Tallest) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 
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Return  Values 


Return  Value 


draw  text  label 


Meanin 


initiates  labeli 


Table  2.8.2.2-4:  Function  Summary  -  time_action  (Region,  Overline) 


Parameter 


Reaion 


Overline 


Parameters 


Where  Typedef  Declared 


inter  to  OPTION  REGION  I  option. h 


inter  to  OVERLINE  I  overline.h 


Calls  1 

Function 

Where  Described 

maihue 

Concurrent  Graphics  library  subroutine 

mark  box 

option.c 

draw  time 

Overlavif.c 

et  strin 


Overlavif.c 


Table  2.8.2.2-5:  Function  Summary  -  unitl_label 
(LimitX,  StartY,  StartX,  Tallest) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Typedef  Declared 


standard 


standard 


standard 


standard 


Return  Value 


draw  text  label 


Return  Values 


Meanin 


initiates  labeli 


Table  2.8.2.2-6:  Function  Summary 
(Region,  Overline) 


-  unitl  action 


Parameter 


Reaion 


Overline 


Parameters 


e 


inter  to  OPTION  REGION 


inter  to  OVERLINE 


Where  Typedef  Declared 


option,  h 


overline.h 


1  Calls 

Function 

Where  Described 

mqihue 

Concurrent  araphics  library  subroutine 

mark  box 

option.c 

draw  blabelt 

Overlineif.c 

Overiavit.c 
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Table  2.8.2.2-7:  Function  Summary  -  unit2_label 
(LimitX,  StartY,  StartX,  Tallest) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tynedef  Declared 


standard 


standard 


standard 


standard 


Return  Value 


draw  text  latsel 


Return  Values 


Meanin 


initiates  labeli 


Table  2.8.2.2-8:  Function  Summary  -  unit2_action  (Region,  Overline) 


Parameter 


Reoion 


Overline 


Parameters 


e  I  Where  Tvoedef  Declared 


inter  to  OPTION  REGION  oorion.h 


inter  to  OVERLINE  I  overline. h 


Function 


mqihue 


mark  box 


draw  blabel2 


et  strin 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


option.c 


Overlineif.c 


Overtayif.c 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Table  2.8.2.2-9:  Function  Summary  -  solidjabel 
(LimitX,  StartY,  StartX,  Tallest) 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Return  Value 


draw  text  label 


Return  Values 


Meanin 


initiates  labelina  function 


Table  2.8.2.2-10:  Function  Summary  -  solid_action  (Region,  Overline) 


_  Parameters 


Parameter 

[Type _ 1 

Where  Typedef  Declared 

Reoion 

_£0 

JX) 

inter  to  OPTION  REGION 

option.h 

Overline 

inter  to  OVERLINE 

overline.h 
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Function 


dashed  action 


mgmue 


mark  box 


draw  line 


draw  Isize 


Calls 


Where  Described 


this  file 


Concurrent  or 


,  option.c 


Overlineif.c 


Overlineif.c 


ics  Nbrarv  subroutine 


Table  2.8.2.2>11:  Function  Summary  -  dashed_label 
(LimitX,  StartY,  StartX,  Tallest) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Return  Value 


draw  text  label 


Return  Values 


Meanin 


initiates  labeli 


Table  2.8.2.2>12:  Function  Summary  -  dashed_action  (Region,  Overline) 


Parameter 


Reoion 


Overline 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  OPTION  REGION  ootion.h 


inter  to  OVERLINE  overline. h 


Function 


solid  action 


moihue 


mark  box 


draw  line 


draw  Isize 


Calls 


Where  Described 


this  file 


Concurrent  oraphics  library  subroutine 


option.c 


Overlineif.c 


Overlineif.c 


Table  2.8.2.2-13:  Function  Summary  -  thinjabel 
(LimitX,  StartY,  StartX,  Tallest) 
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Table  2.8.2.2-14:  Function  Summary  -  thin_action  (Region,  Overline) 


1  Parameters  1 

Parameter 

Tvne 

Where  Tvpedef  Declared 

Reoion 

pointer  to  OPTION  REGION 

option.h 

Overline 

pointer  to  OVERLINE 

overline.h 

Ca 

Is 

Function 

Where  Described 

thick  action 

OvIine  func.c 

mgihue 

Concurrent  graphics  library  subroutine 

mark  box 

option.c 

draw  tine 

Overtineif.c 

draw  Isize 

Overlineif.c 

draw  name 

Overlineif.c 

draw  time 

Overlayif.c 

Table  2.8.2.2-15:  Function  Summary  -  thick_label 
(LimitX,  StartY,  StartX,  Tallest) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

draw  text  label 

int 

initiates  labeling 

Table  2.8.2.2-16:  Function  Summary  -  thick_action  (Region,  Overline) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Region 

pointer  to  OPTION  REGION 

option.h 

Overline 

pointer  to  OVERLINE 

overline.h 
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Function 


thin  action 


maihue 


mark  box 


draw  line 


draw  Isize 


draw  name 


draw  time 


Calls 


Where  Described 


this  file 


Concurrent  oraphics  Nbrary  subroutine 


option.c 


Overlineif.c 


Overtineif.c 


Overlineif.c 


Overtineif.c 


Table  2.8.2.2-17:  Function  Summary  -  lgeneric_size  (Size,  Overline) 


Parameters 


Parameter 


Size 


Overline 


Function 


maihue 


mark  box 


draw  Isize 


inter  to  OVERLINE 


Where  Tvpedef  Declared 


standard 


overline. h 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


option.c 


Overlineif.c 


Table  2.8.2.2-18:  Function  Summary  -  lsquad_action  (Region,  Overline) 


Parameters 


Parameter 


Reaion 


Overline 


uTd 

e _ 1 

Where  Typedef  Declared 

JO 

inter  to  OPTION  REGION 

option. h 

po 

inter  to  OVERLINE 

overline. h 

Function 


laenenc  size 


Calls 


Where  Described 


this  file 


Table  2.8.2.2-19:  Function  Summary  -  lsection_action  (Region,  Overline) 


Parameters 


Parameter 


Reaion 


Overiine 


iin 

e _ 1 

Where  Typedef  Declared 

JO 

inter  to  OPTION  REGION 

option. h 

po 

inter  to  OVERLINE 

overline. h 

Calls 

Function 

Where  Described 

Iqeneric  size 

this  file 
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Table  2.8.2.2-20:  Function  Summary  -  lplatoon_action  (Region,  Overline) 


Parameter 


Reoion 


Overline 


Parameters 


e  Where  Tynedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  OVERLINE  i  overline. h 


Function 


moihue 


mark  box 


draw  Isize 


Iqenenc  size 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


option.c 


Overtineif.c 


this  file 


Table  2.8.2.2-21:  Function  Summary  -  ltroop_action  (Region,  Overline) 


Parameter 


Reoion 


Overline 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  OVERLINE  overline. h 


Function 


Iqeneric  size 


Calls 


Where  Described 


this  file 


Table  2.8.2.2-22:  Function  Summary  -  Ibattalion^action  (Region, 

Overline) 


Parameter 


Reqion 


Overline 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  OVERLINE  overline. h 


Calls 

Function 

Where  Described 

Iqeneric  size 

this  file 

Table  2.8.2.2-23:  Function  Summary  -  lgroup_action  (Region,  Overline) 


Parameter 


Reqion 


Overline 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  OVERLINE  overline. h 


Calls  1 

Function 

Where  Described 

Iqeneric  size 

this  file 
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Table  2.8.2.2*24:  Function  Summary  -  igeneric_type  (Type,  Overline) 


Parameter 


e 


Overline 


Parameters 


inter  to  OVERLINE 


Where  Tvnedef  Declared 


standard 


overlme.h 


Function 


maihue 


mark  box 


loenenc  size 


draw  Isize 


room  for  Isize 


draw 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


option.c 


this  file 


Overlineif.c 


Overlineif.c 


Overlineif.c 


Table  2.8.2.2*25:  Function  Summary  -  boundary_labeI 
(LimitX,  StartY,  StartX,  Tallest) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Return  Value 


draw  text  label 


Return  Values 


Meanin 


initiates  label! 


Table  2.8.2.2*26: 


Function  Summary  -  boundary_action 
(Regioi,  Overline) 


Parameter 


Reoion 


Overline 


Parameters 


e 


inter  to  OPTION  REGION 


inter  to  OVERLINE 


Where  Tvoedef  Declared 


option. h 


overline. h 


1  Calls 

Function 

Where  Described 

unit1  action 

this  file 

unit2  action 

this  file 

loeneric  size 

this  file 

maihue 

Concurrent  araphics  library  subroutine 

mark  box 

option.c 

draw  Isize 

Overlineif.c 

room  for  Isize 

Overlineif.c 

loeneric  type 

this  file 
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Table  2.8.2.2-27:  Function  Summary  -  Ideparturejabel 
(LimitX,  StartY,  StartX,  Tallest) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Return  Value 


draw  text  label 


Return  Values 


Meanin 


initiates  labeli 


Table  2.8.2.2-28:  Function  Summary  -  ideparture_action 

(Region,  Overline)  ~ 


Parameters 


Parameter 


Reaion 


Overline 


Where  Tvoedef  Declared 


inter  to  OPTION  REGION  I  ODtion.h 


inter  to  OVERLINE 


overline. h 


Function 


loeneric  tvoe 


Calls 


Where  Described 


this  file 


Table  2.8.2.2-29:  Function  Summary  -  phase Jabel 
(LimitX,  StartY,  StartX,  Tallest) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Return  Value 


draw  text  label 


Return  Values 


Meanin 


initiates  labeli 


Table  2.8.2.2-30:  Function  Summary  -  phase_action  (Region,  Overline) 


Parameters 


Parameter 

IDTd 

e  1 

Where  Tvoedef  Declared 

Region 

_£0 

inter  to  OPTION  REGION 

option. h 

Overline 

po 

inter  to  OVERLINE 

overline. h 
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Function 


maihue 


mark  box 


draw 


laeneric  tvoe 


Calls 


Where  Described 


Concurrent  oraphics  Ubrary  subroutine 


option.c 


Overtineif.c 


this  file 


Table  2.8.2.2-31:  Function  Summary  -  pdepIoymenMabel 
(LimitX,  StartY,  StartX,  Tallest) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Return  Value 


draw  text  label 


Return  Values 


Meanin 


initiates  labeli 


Table  2.8.2.2-32:  Function  Summary  -  pdeployment_action 

(Region,  Overline) 


Parameter 


Reoion 


Overline 


Parameters 


inter  to  OVERLINE 


Where  Tvpedef  Declared 


inter  to  OPTION  REGION  option. h 


overline. h 


Function 


Iqeneric  tvoe 


Calls 


Where  Described 


this  file 


Table  2.8.2.2-33:  Function  Summary  -  nonre_labei 
(LimitX,  StartY,  StartX,  Tallest) 
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Table  2.8.2.2-34:  Function  Summary  -  nofire_action 
(Region,  Overline) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Reaion 

pointer  to  OPTION  REGION 

option. h 

Overline 

pointer  to  OVERLINE 

overline. h 

1  Calls  1 

Function 

Where  Described 

Iqeneric  type 

this  file 

Table  2.8.2.2-35:  Function  Summary  -  delay_label 
(LimitX,  StartY,  StartX,  Tallest) 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

j  Return  Values  1 

Return  Value 

Type 

Meanlna 

draw  text  label 

int 

inititates  labelinq 

Table  2.8.2.2-36:  Function  Summary  -  delay_action  (Region,  Overline) 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Reqion 

pointer  to  OPTION  REGION 

option. h 

Overline 

pointer  to  OVERLINE 

overline. h 

1  Calls  1 

Function 

Where  Described 

Iqeneric  type 

this  file 

Table  2.8.2.2-37:  Function  Summary  -  freejabel 
(LimitX,  StartY,  StartX,  Tallest) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 
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Table  2.8.2.2-38:  Function  Summary  -  free_action  (Region,  Overline) 


Parameter 


Reaion 


Overline 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  OVERLINE  overline. h 


Function 


loeneric  tvoe 


Calls 


Where  Described 


this  file 


Table  2.8.2.2-39:  Function  Summary  -  ldone_create_action 

(Region,  Overline) 


Parameters 


Parameter 

luTd 

e  1 

Where  Tvpedef  Declared 

Reaion 

po 

inter  to  OPTION  REGION 

option. h 

Overline 

DO 

inter  to  OVERLINE 

overline. h 

Function 


reset  reoion 


delete  window 


Calls 


Where  Described 


option. c 


windows. c 


2. 8. 2. 3  overdraw.c  CSU  Description  (/simnet/pvd/lib/liboverlay.a) 
This  CSU  draws  overlay  lines  from  menu  choices  for  free  drawing. 


Table  2.8.2.3-1:  Function  Summary  -  draw_overline(Overline,  Window, 
Planes,  PenciIHue,  ClearHue,  Mode) 

This  function  draws  an  overline. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 

Window 

int 

standard 

Planes 

int 

standard 

PenciIHue 

int 

standard 

ClearHue 

int 

standard 

Mode 

int 

standard 
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Ca 

Is 

Function 

Where  Described 

Concurrent  oraphics  Nbrary  subroutine 

Concurrent  oraphics  library  subroutine 

maimodfunc 

Concurrent  oraphics  Kbrary  subroutine 

moihue 

Concurrent  oraphics  library  subroutine 

calc  zoom  ratio 

New  overlay.c 

moiwidth 

Concurrent  oraphics  library  subroutine 

Concurrent  oraphics  library  subroutine 

1  over  user  to  pixel 

New  overlay.c 

Concurrent  oraphics  library  subroutine 

Concurrent  oraphics  Kbrary  subroutine 

overline  features 

this  file 

add  size 

this  file 

Table  2.8.2.3-2:  Function  Summary  -  add_segment(Overline,  Offset) 
This  function  draws  a  segment  from  the  current  end  of  line  to  the  new  offset. 


Parameter 


Overline 


Offset 


Parameters 


e 


inter  to  OVERLINE 


inter  to  OFFSET 


Where  Tvoedef  Declared 


overline. h 


overline. h 


Function 


moihue 


over  user  to  oixel 


iti 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


New  overlay.c 


Concurrent  Graphics  library  subroutine 


Table  2.8.2.3-3:  Function  Summary  -  erase_segment(Overline,  EndPoint) 


This  function  erases  the  last  segment  in  the  line  and  cleans  up. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Overline 

pointer  to  OVERLINE 

overline. h 

Offset 

pointer  to  OFFSET 

overline.h 

1  Calls  1 

Function 

Where  Described 

moihue 

Concurrent  oraphics  library  subroutine 

over  user  to  pixel 

New  overlay.c 

Concurrent  oraphics  Nbrary  subroutine 
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Table  2.8.2.3-4: 


Function  Summary  -  ad[d_size(OverUne,  OffsetNum, 
Planes,  PenciIHue,  CleaT'Hue) 


Parameters 


Parameter 


Overline 


OffsetNum 


Planes 


PenciIHue 


ClearHue 


Where  Tvoedef  Declared 


overline.h 


standard 


standard 


standard 


standard 


Function 


iv 


In 


maihue 


calc  zoom  ratio 


iwidth 


et  anole 


et  need 


over  user  to  pixel 


size  on  line 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


New  overlay.c 


Concurrent  oraohics  library  subroutine 


Overdraw.c 


this  file 


New  overlay.c 


this  file 


Table  2.8.2.3>5:  Function  Summary  •>  overline_features 
(Overline,  Planes,  PenciIHue) 
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Parameter 


Ovedine 


Table  2.8.2.3-6:  Function  Summary  -  add_name(Overline) 


Parameters 


inter  to  OVERLINE 


Where  Tvoedef  Declared 


overlina.h 


Calls  1 

Function 

Where  Described 

over  user  to  pixel 

New  overlav.c 

Concurrent  oraohics  Nbrarv  subroutine 


Concurrent  oraohics  Nbrarv  subroutine 


Table  2.8.2.3-7:  Function  Summary  -  add_time(Overline) 
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Table  2.8.2.3-9:  Function  Summary  -  add_free_text 
(Text,  Window,  Planes,  Hue)  ~ 


Parameters 


Parameter 


Text 


Window 


Planes 


Hue 


Where  Typedef  Declared 


svmbol.h 


standard 


standard 


standard 


Function 


IV 


In 


maihue 


over  user  to  pixel 


f 


s 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


New  overlay.c 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.8.2.3-10:  Function  Summary  -  add_endlabels(Overline,  Type) 


Parameter 


Overline 


e 


Parameters 


e 


inter  to  OVERLINE 


inter  to  char 


Where  Typedef  Declared 


overline.h 


standard 


Calls  1 

Function 

Where  Described 

over  user  topixel 

New  overlay.c 

Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.8.2.3-11:  Function  Summary  -  add_midlabel 
(Overline,  String,  Side) 


Parameter 


Overline 


Strin 


Side 


Parameters 


inter  to  OVERLINE 


inter  to  char 


Where  Typedef  Declared 


overline.h 


standard 


standard 


Calls  1 

Function 

Where  Described 

over  user  to  oixel 

New  overlay.c 

|lUl*ll! 


et  anole 


f 


s 


this  file 


Concurrent  qraohics  library  subroutine 


Concurrent  oraphics  library  subroutine 
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Table  2.8.2.3-12:  Function  Summary  -  size  on  line(Overline,  Angle, 
Numicons,  LineWidth,  StartX,  StartY,  FencTlHue,  ClearHue) 

This  function  draws  the  size  on  boundary  lines. 


Parameter 


Overline 


Angle 


Numicons 


LineWidth 


StartX.  StartY 


PenciIHue.  ClearHue 


Parameters 


e 


inter  to  OVERLINE 


double 


int 


int 


mt 


int 


Where  Tvpedef  Declared 


overline.h 


standard 


standard 


standard 


standard 


standard 


1  Calls 

Function 

Where  Described 

mgihue 

Concurrent  graphics  library  subroutine 

lin^ 
IIS? 
IEj? 


iwidth 


f 


s 


iti 


ifc 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Table  2.8.2.3-13:  Function  Summary  -  find_offset 
(Overline,  ChosenX,  ChosenY) 
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Table  2.8.2.3>14:  Function  Summary  -  get_need(Overline) 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

Overline 

pointer  to  OVERLINE 

overline.h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

Numicons 

int 

displays  number  icons 

1  Calls  1 

Function 

Where  Described 

over  user  to  pixel 

New  overlav.c 

Concurrent  qraphics  Kbrary  subroutine 

Concurrent  qraphics  library  subroutine 

Table  2.8.2.3-15:  Function  Summary  -  get_angle(OffsetX,  OffsetY) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

OffsetX.  OffsetY 

short 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

Angle 

double 

value  of  angle 

2. 8. 2. 4  overline.c  CSU  Description  (/simnet/pvd/Iib/liboverlay.a) 

This  CSU  contains  routines  that  handle  overlines,  including  boundaries  and  control  lines.  It 
manages  OverlineTable. 

Table  2.8.2.4-1:  Function  Summary  -  overiine_init(  ) 

This  function  initializes  the  Overline  Table. 

Table  2.8.2.4-2:  Function  Summary  -  overline_reset(  ) 

This  function  reinitializes  the  Overline  Table. 
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Table  2.8.2.4-3:  Function  Summary  -  get_free_overIine(  ) 

This  function  allocates  an  overline  structure  and  returns  a  pointer  to  the  newly  allocated 
overline. 


1  Return  Values  1 

Return  Value 

Type 

Meanina 

Line 

pointer  to  OVERLiNE 

pointer  to  newly  allocated 
overtine 

Table  2.8.2.4-4:  Function  Summary  -  copy_overline(From,  To) 

This  function  creates  a  copy  of  an  overline. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

From,  To 

pointer  to  OVERLINE 

overline. h 

Table  2.8.2.4-5:  Function  Summary  -  zoom_overIine 
(Planes,  PenciIHue,  ClearHue) 

This  function  redraws  the  active  lines  in  the  Overline  Table  at  the  appropriate  zoom  level 
and  in  the  given  planes. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Planes 

int 

standard 

PenciIHue.  ClearHue 

int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  overline 

Overdraw.c 

Table  2.8.2.4>6:  Function  Summary  -  erase_overline(Pianes,  ClearHue) 
This  function  erases  all  the  free  draw  objects  in  the  Overline  Table. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Planes 

int 

standard 

ClearHue 

int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  overline 

Overdraw.c 
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Table  2.8.2.4-7: 


Function  Summary  -  insert_overIine(NewLine) 


This  function  inserts  NewLine  into  the  Overline  Table. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

NewLine 

pointer  to  OVERLINE 

overline.h 

Table  2.8.2.4-8:  Function  Summary  -  mouse_to_overline(MouseX, 

MouseY) 

This  function  finds  (and  returns  a  pointer  to)  the  overline  whose  end  points  are  closest  to 
the  given  set  of  mouse  coordinates. 


1  Parameters  i 

Parameter 

Where  Tvoedef  Declared 

MouseX,  MouseY 

int 

X.  Y  coordinates 

1  Return  Values  1 

Return  Value 

Meaning 

CurOverline 

pointer  to  OVERLINE 

returns  pointer  to  overline 
whose  endpoints  are  close  to 
mouse  coordinates 

NULL 

pointer  to  OVERLINE 

no  matchina  overline  found 

Ca 

Is 

Function 

Where  Described 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  librarv  subroutine 

calc  zoom  ratio 

New  overlav.c 

over  user  to  pixel 

New  overlav.c 

over  point  in  box 

New  overlav.c 
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2.8.3  Unit  Symbols  CSC  Description 

This  CSC  enables  military  unit  symbols  to  be  created  and  edited. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.8.3- 1. 


Unit 

Symbols 

3.8.3 


symbolif.c 
3.8.3. 1 

symbol._ 

func.c 

3.83.2 

symboLc 

3.8.3.3 

symdraw.c 

3.83.4 


Figure  2.8.3-1:  Overlays— Unit  Symbols  CSC  Structure. 

2. 8. 3.1  symbolif.c 

This  CSU  manages  military  unit  symbols.  It  contains  routines  for  displaying  popup 
windows  and  for  creating  and  modifying  the  symbols. 


262 


BBN  Systems  and  Technologies 


Plan  View  Display  CSCI 


Table  2.8.3. 1-1:  Function  Summary  -  symbol_create(  ) 
This  function  displays  the  pop  window  for  creating  military  symbols. 


r 

Eg 

Cl^ 


Function 


draw  create  window 


et  free  symbol 


iv 


in 


display  block 


moihue 


mark  box 


calc  basic  dim 


friend  action 


actual  action 


unit  action 


latoon  action 


mouse  to  option 


handle  popup  windows 


etcursmode 


display  cursor  loc 


imodfunc 


draw  symbol 


etvcoor 


default  mouse  hel 


Calls 


Where  Described 


this  file 


symbol.c 


Concurrent  oraphics  Kbrary  subroutine 


Concurrent  oraphics  library  subroutine 


option.c 


Concurrent  oraphics  Kbrary  subroutine 


option.c 


symbol.c 


symbol  func.c 


symbol  func.c 


symbol  func.c 


symbol  func.c 


option.c 


windows.c 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


symbol.c 


Concurrent  oraphics  library  subroutine 


Table  2.8.3.1-2:  Function  Summary  •  draw_create_window(  ) 

This  function  creates  a  pop_window  and  defines  the  SymbolRegion  if  it  is  the  first  time 
being  draw.  It  also  draws  the  window. 
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Table  2.8.3.1-3:  Function  Summary  -  sym_reg_def(  PopWindow  ) 

This  function  creates  a  symbol  region  to  fit  inside  a  window  with  the  characteristics  of  the 
opo  window  given. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

PopWindow 

pointer  to  struct  PopWindow 

symbolif.h 

1  Calls  1 

Function 

Where  Described 

option  red  define 

option.c 

define  block 

option.c 

Table  2.8.3.1*4:  Function  Summary  -  del_create_window(  ) 

This  function  erases  the  pop  window,  r^  sets  all  the  options  in  SymbolRegion,  and  resets 
SymbolCreatelsUp  (that  is,  it  sets  it  to  0.) 


1  Calls  1 

Function 

Where  Described 

reset  reaion 

option.c 

delete  window 

pop  windows.c 

Table  2.8.3.1*5:  Function  Summary  •  select_symbol(  ) 

This  function  selects  one  of  the  symbols  displayed  by  placing  the  cursor  inside  it  and 
pressing  the  left  button.  Returns  1  if  the  symbol  was  selected  and  0  otherwise.  Selected 
symbols  experience  a  color  change. 


1  Calls  1 

Function 

Where  Described 

uncolor  selected 

symbolif.c 

mouse  to  symbol 

symbol.c 

color  selected 

symbolif.c 

1  Return  Values  I 

Return  Value 

Type 

Meanina 

1 

ini 

symbol  selected 

0 

int 

othenwise 
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Table  2.8.3. 1-6:  Function  Summary  -  symbol_edit(  ) 
This  function  the  selected  symbol  and  modified  it. 


Function 


et  free  symbol 


symbol 


draw  create  window 


calc  basic  dim 


et  window  num 


In 


display  block 


maihue 


mark  box 


show  symbol 


mouse  to  option 


UP  windows 


calc  zoom  ratio 


uncolor  selected 


draw  symbol 


Calls 


Where  Described 


symbol.c 


symbol.c 


this  file 


symbol.c 


Concurrent  oraphics  library  subroutine 


windows.c 


Concurrent  oraphics  library  subroutine 


option.c 


Concurrent  oraphics  library  subroutine 


option.c 


this  file 


option.c 


windows.c 


new  oyerlay.c 


symbolif.c 


symbol.c 


Table  2.8.3.1-7:  Function  Summary  -  $ymbol_move(  ) 
This  function  takes  the  selected  symbol  and  moves  it. 
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Table  2.8.3.1-8:  Function  Summary  •  symbol_delete(  ) 
This  function  deletes  the  selected  symbol. 


Ca 

Is 

Function 

Where  Described 

calc  zoom  ratio 

new  overiay.c 

calc  basic  dim 

symbol.c 

uncolor  selected 

symbolif.c 

maimodfunc 

Concurrent  oraphics  library  subroutine 

draw  symbol 

symbol.c 

zoom  overlay 

overtayif.c 

Table  2.8.3. 1>9:  Function  Summary  •  show_symboI(  Symbol  ) 

This  function  draws  the  current  symbol  in  the  pop  window  by  selecting  the  appropriate 
options.  Assumes  that  the  symbol  region  has  been  reset  and  thus  none  of  the  options  are 
marked  Selected. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

Is 

Function 

Where  Described 

mark  box 

option.c 

draw  desiqnation 

symdraw.c 

draw  hi  eche 

symdraw.c 

friend  action 

symbol  func.c 

foe  action 

symbol  func.c 

draw  box 

draw  proposed 

symdraw.c 

mqidash 

Concurrent  graphics  library  subroutine 

generic  box 

symbol  func.c 

generic  size 

symbol  func.c 

symbol  func.c 

generic  branch 

symbol  func.c 

generic  weapon 

symbol  func.c 

Table  2.8.3.1>10:  Function  Summary  •  symbol_addtext(  ) 

This  function  tries  to  add  text  to  an  active  symbol.  If  there  are  more  text  strings  attached  to 
the  symbol,  it  will  announce  the  error  and  abort  the  operation. 


Cal 

Is 

Function 

Where  Described 

gen  add  text 

overtayif.c 

uncolor  selected 

symbolif.c 

draw  symbol 

symbol.c 

1  ri  !iil  I'i  I'll' 

overtayif.c 
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Table  2.8.3.1-11:  Function  Summary  •  color_selected(  Symbol  ) 


Parameters 


Parameter 


Symbol 


Function 


draw  symbol 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


symbolif.h 


Calls 


Where  Described 


symbol.c 


Table  2.8.3.1-12:  Function  Summary  -  uncolor_selected(  Symbol  ) 


Parameters 


Parameter 


Symbol 


Function 


draw  symbol 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


symbolif.h 


Calls 


Where  Described 


symbol.c 


Table  2.8.3.1-13:  Function  Summary  -  symbol_reduce(  ) 


Function 


resize  mouse  hel 


resize  symbol 


default  mouse  hel 


Calls 


Where  Described 


this  file 


overlayif.c 


Table  2.8.3.1-14:  Function  Summary  -  resize_symboi(  Flag  ) 


Parameters 


Parameter 


Where  Tvoedef  Declared 


standard 


Calls  1 

Function 

Where  Described 

uncolor  selected 

this  file 

draw  symbol 

symbol.c 
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2. 8. 3. 2  symbol_func.c 

This  CSU  contains  routines  for  selecting  symbols  and  labeling  them  on  the  screen. 


Table  2.8.3.2-1:  Function  Summary  -  desigjabel 
(  LimitX,  StartYy  StartX,  Tallest  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  text  label 

option. c 

1  Return  Values  1 

Return  Value 

Meanlnp 

draw  text  label 

int 

•Designation” 

Table  2.8.3.2-2:  Function  Summary  •  desig_action(Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Region 

pointer  to  OPTION  REGION 

option,  h 

Symbol 

pointer  to  SYMBOL 

svmbolif.h 

1  Calls  1 

Function 

Where  Described 

mgihue 

Concurrent  graphics  library  subroutine 

mark  box 

option.c 

draw  designation 

symdraw.c 

Table  2.8.3.2>3:  Function  Summary  •  hi_echejabel 
(  LimitX,  StartY,  StartX,  Tallest~) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 
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Return  Values 


Return  Value 


draw  text  label 


Meanin 


Hiaher  echelons  of  command” 


Table  2.8.3.2-4:  Function  Summary  -  hi_eche_action(  Region,  Symbol  ) 


Parameter 


Reaion 


Symbol 


Function 


maihue 


mark  box 


draw  hi  eche 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  OPTION  REGION  I  option. h  _ 


inter  to  SYMBOL  I  svmbolif.h 


Calls 


Where  Described 


Concurrent  araphds  hbrary  subroutine 


option.c 


svmdraw.c 


Table  2.8.3.2-5:  Function  Summary  -  friend_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameters 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


inter  to  int 


inter  to  Int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Table  2.8.3.2-6:  Function  Summary  •  friend_action(  Region,  Symbol  ) 


Parameter 


Reaion 


Symbol 


Parameters 


e  Where  Tvpedef  Declared 


inter  to  OPTION  REGION  option.h 


inter  to  SYMBOL  symbolif.h 


Function 

Where  Described 

foe  action 

this  file 

maihue 

Concurrent  araphics  library  subroutine 

mark  box 

option.c 
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Table  2.8.3.2>7:  Function  Summary  •  foe_label 
(  LimitXy  StartY,  StartX,  Tallest  ) 


Parameter 


UmitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


Enemy  symbol” 


Table  2.8.3.2-8:  Function  Summary  •  foe_action(Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Parameters 


e  Where  Tvpedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  symbolif.h 


Function 


friend  action 


moihue 


mark  box 


Calls 


Where  Described 


this  file 


Concurrent  oraphics  library  subroutine 


option.c 


Table  2.8.3.2-9:  Function  Summary  -  actualjabel 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameters 

Parameter 

Type 

Where  Tvpedef  Declared 

UmitX 

int 

standard 

StartY 

int 

standard 

StartX 


Tallest 


inter  to  int 


inter  to  int 


standard 


standard 


1  Calls 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


“Placed  on  actual  location" 
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Table  2.8.3.2-10:  Function  Summary  •actual_action(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Region 

pointer  to  OPTION  REGION 

option.h 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

IIS 

Function 

Where  Described 

proposed  action 

this  file 

moihue 

Concurrent  oraphics  library  subroutine 

mark  box 

option.c 

draw  proposed 

ntoidash 

Concurrent  oraphics  Bbrarv  subroutine  1 

draw  box 

Table  2.8.3.2-11:  Function  Summary  -  proposedjabel 
(  LimitX,  Start Y,  StartX,  Tallest  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StaitX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

draw  text  label 

int 

‘Placed  on  proposed  location" 

Table  2.8.3.2-12:  Function  Summary  -  proposed_action(  Region,  Symbol  ) 


Parameter 


Reaion 


Symbol 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  I  option. h 


inter  to  SYMBOL  I  svmbolif.h 


Function 


actual  action 


moihue 


mark  box 


draw  box 


idash 


draw  proposed 


Calls 


Where  Described 


this  file 


Concurrent  oraphics  library  subroutine 


option.c 


symdraw.c 


Concurrent  oraphics  library  subroutine 


symdraw.c  _ 
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Table  2.8.3.2-13:  Function  Summary  -  generic_box(  Shape,  Symbol  ) 


Parameters 


Parameter 


Shape 


Symbol 


inter  to  SYMBOL 


Where  Tvpedef  Declared 


standard 


svmboHf.h 


Function 


maihue 


mark  box 


draw  box 


idash 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


option.c 


synxJraw.c 


Concurrent  oraphics  library  subroutine 


Table  2.8.3.2-14:  Function  Summary  -  unitjabel 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


1  Calls 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


Unit” 


Table  2.8.3.2-:15  Function  Summary  -  unit_action(  Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Parameters 


e  Where  Tvpedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  I  symbolif  .h 


1  Calls 

Function 

Where  Described 

mgihue 

Concurrent  graphics  library  subroutine 

mark  box 

option.c 

draw  box 

symdraw.c 

idash 


eneric  box 


Concurrent  graphics  library  subroutine 


this  file 
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Table  2.8.3.2-16:  Function  Summary  -  headq_label 
(  LimitXy  StartY,  StartX,  Tallest  ) 


Parameters 


Parameter 


UmitX 


StartY 


StartX 


Tallest 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Calls 


Function 

Where  Described 

draw  text  label 

ODtion.c  _ 

Return  Values 


Return  Value 


draw  text  label 


Headauarters” 


Table  2.8.3.2-17:  Function  Summary  -  headq_action(  Region,  Symbol  ) 


Parameter 


Reqion 


Symbol 


Function 


enenc  box 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  I  symbolif  .h 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-18:  Function  Summary  -  cssjabel 
(  LimitX,  StartY,  StartX,  Tallest  ) 
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Table  2.8.3.2-19:  Function  Summary  -  css_action(  Region,  Symbol  ) 


Parameter 


Reoion 


Svmbol 


Function 


enenc  box 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  ODtion.h 


inter  to  SYMBOL  svmboNf.h 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-20:  Function  Summary  •  generic_size(  Size,  Symbol  ) 


Parameters 


Parameter 


Size 


Svmbol 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


standard 


symbolif.h 


Function 


maihue 


mark  box 


draw  size 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


ODtion.c 


svmdraw.c 


Table  2.8.3.2-21:  Function  Summary  -  squad  label 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Calls 

Function 

Where  Described 

draw  text  label 

ODtion.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


Souad 


Table  2.8.3.2-22:  Function  Summary  -  squad_action(  Region,  Symbol  ) 


Parameter 


Reaion 


Svmbol 


irs 

irs 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  symbolif.h 
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Function 


eneric  size 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-23:  Function  Summary  -  sectionjabel 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameters 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Return  Value 


draw  text  label 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


Calls 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Values 


Meanin 


Section" 


Table  2.8.3.2-24:  Function  Summary  -  section_action(  Region,  Symbol  ) 


Parameter 


Region 


Symbol 


Function 


eneric  size 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  svmbolif.h 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-25:  Function  Summary  -  platoon_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


ion 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


1  Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 
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Return  Values 


Return  Value 


draw  text  label 


Table  2.8.3.2>26:  Function  Summary  •  platoon_action(  Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Function 


moihue 


mark  box 


draw  size 


eneric  size 


Parameters  _ _ 


Where  Typedef  Declared 


inter  to  OPTION  REGION  I  option.h _ _ 


inter  to  SYMBOL  _  I  svmbolif.h 


Calls  _ 


Where  Described  _ 


Concurrent  oraphics  library  subroutine  _ 


option.c  _ 


svmdraw.c 


this  file 


Table  2.8.3.2-27:  Function  Summary  -  troopjabel 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


tandard 


standard 


standard 


standard 


r  calls 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Values 


Return  Value 


draw  text  label 


Company,  Battery.  Troo 


Table  2.8.3,2-28:  Function  Summary  •  lnM>p_act!on(  Region,  Symbol  ) 


Parameter 


Reqlon 


Symbol 


Function 


eneric  size 


Parameters  _ 


Where  Tvpedef  Declared 


inter  to  OPTION  REGION  I  option.h  _  _ 


inter  to  SYMBOL  _  I  svmbolif.h 


Calls  _ 


Where  Described 


this  file 
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Table  2.8.3.2-29:  Function  Summary  -  battalion  label 
(  LimitX,  StartY,  StartX,  Tallest  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

1  Return  Values  1 

Return  Value 

Meanina 

draw  text  label 

int 

“Battalion,  Squadron" 

Table  2.8.3.2-30:  Function  Summary  -  battalion_action(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Reqion 

pointer  to  OPTION  REGION 

option. h 

Symbol 

pointer  to  SYMBOL 

svmbolif.h 

1  Calls  1 

Function 

Where  Described 

generic  size 

this  file 

Table  2.8.3.2-31:  Function  Summary  -  groupjabel 
(  LimitX,  StartY,  StartX,  Tallest  ) 
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Table  2.8.3.2-32:  Function  Summary  -  group_action(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

Region 

pointer  to  OPTION  REGION 

option.h 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

1  Calls  1 

Function 

Where  Described 

aeneric  size 

this  file 

Table  2.8.3.2-33:  Function  Summary  -  generic_branch(Branch,  Symbol  ) 


1  Parameters  1 

Parameter 

Tvoe 

Where  Typedef  Declared 

Branch 

int 

standard 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

Is 

Function 

Where  Described 

maihue 

Concurrent  araphics  library  subroutine 

mark  box 

option. c 

draw  branch 

symdraw.c 

Table  2.8.3.2-34:  Function  Summary  -  air_def_art_label 
(  LimitX,  StartY,  StartX,  Tallesf ) 
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Table  2.8.3.2-35:  Function  Summary  -  air_def_art_action 

(  Region,  Symbol  ) 


Parameter 


Reqion 


Symbol 


Function 


enenc  branch 


Parameters 


e  Where  Tynedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  svmbolif.h 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-36:  Function  Summary  -  armorjabel 
(  LimitX,  StartY,  StartX,  Tallest  )  ~ 


Parameters 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


Calls  1 

Function 

Where  Described 

draw  text  label 

option. c 

Return  Values 


Return  Value 


draw  text  label 


Meanin 


“Armor 


Table  2.8.3.2-37:  Function  Summary  -  armor_action(  Region,  Symbol  ) 
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Table  2.8.3.2-38:  Function  Summary  -  nbcjabel 
(  LimitX,  StartYy  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Calls 


Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


NBC- 


Table  2.8.3.2-39:  Function  Summary  -  nbc_action(  Region,  Symbol  ) 


Parameter 


Reqion 


Symbol 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  svmbolif.h 


Function 


eneric  branch 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-40:  Function  Summary  -  cavalry  label 
(  LimitX,  StartY,  StartX,  Tallest  ) 
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Table  2.8.3.2-41:  Function  Summary  -  cavalry_action(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

Region 

pointer  to  OPTION  REGION 

option,  h 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

lls 

Function 

Where  Described 

generic  branch 

this  file 

Table  2.8.3.2-42:  Function  Summary  •  fleld_arMabel 
(  LimitX,  Start Y,  StartX,  Tallest  )~  ~ 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  text  label 

oDtion.c 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

draw  text  label 

int 

'Field  artillery” 

Table  2.8.3.2-43:  Function  Summary  -  neld_art_action(  Region,  Symbol  ) 
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Table  2.8.3.2-44:  Function  Summary  -  infantryjabel 
(  LimitX,  Start StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvnedef  Declared 


standard 


standard 


standard 


standard 


Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


lEEOn 


Table  2.8.3.2-45:  Function  Summary  •  infantry_action(  Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  svmbolif.h 


Function 


eneric  branch 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-46:  Function  Summary  -  medical_iabel 
(  LimitX,  StartY,  StartX,  Tallest  ) 
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Table  2.8.3.2-47:  Function  Summary  -  medical_action(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Tvne 

Where  Typedef  Declared 

Region 

pointer  to  OPTION  REGION 

option,  h 

Symbol 

pointer  to  SYMBOL 

svmbolif.h 

1  Calls  1 

Function 

Where  Described 

oeneric  branch 

this  file 

Table  2.8.3.2-48:  Function  Summary  -  airbornejabel 
(  LimitX,  StartY,  StartX,  Tallest  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  text  label 

oDtion.c 

1  Return  Values  1 

Return  Value 

Meaning 

draw  text  label 

Lint _ 1 

“Airborne” 
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Table  2.8.3.2-50:  Function  Summary  -  antitankjabel 
(  LimitX,  Start Y,  StartX,  Tallest  ) 


Parameter 


urntX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tynedef  Declared 


standard 


standard 


standard 


standard 


Calls 


Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


“Antitank" 


Table  2.8.3.2-51:  Function  Summary  -  antitank_action(  Region,  Symbol  ) 


Parameter 


Reqion 


Symbol 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  OPTION  REGION  ODtion.h 


inter  to  SYMBOL  symbolif.h 


Function 


eneric  branch 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-52:  Function  Summary  -  army_avi_label 
(  LimitX,  StartY,  StartX,  Tallest  )  ~ 
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Table  2.8.3.2-53:  Function  Summary  -  army_avi_action(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

Reaion 

Dointer  to  OPTION  REGION 

ootion.h 

Symbol 

pointer  to  SYMBC^ 

svmbolif.h 

1  Calls  1 

Function 

Where  Described 

aeneric  branch 

this  file 

Table  2.8.3.2-54:  Function  Summary  -  repairjabel 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tailest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


'Repair  and  maintenance" 


Table  2.8.3.2-55:  Function  Summary  -  repair_action(  Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Function 


eneric  branch 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  OPTION  REGION  oDtion.h 


inter  to  SYMBOL  svmbolif.h 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-56:  Function  Summary  -  generic_supply(  Supply,  Symbol  ) 


Parameters 


Parameter 


Symbol 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


standard 


svmbolif.h 
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Function 


maihue 


mark  box 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


ootion.c 


svmdraw.c 


Table  2.8.3.2-57:  Function  Summary  •  ammo_all_label 
(  LimitXy  StartY,  StartX,  Tallest  ) 
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Table  2.8.3.2>59:  Function  Summary  •  ammo_art_label 
(  LimitX,  StartY,  StartX,  Tallest  )  ~ 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


Calls 


Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


•Artille 


Table  2.8.3.2-60:  Function  Summary  -  ammo_art_action 

(  Region,  Symbol  )  ~  ~ 


Parameter 


Reaion 


Symbol 


Parameters 


Where  Typedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  I  svmbolif.h 


Function 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-61:  Function  Summary  •  ammo_rock_label 
(  LimitX,  StartY,  StartX,  Tallest  )~  ~ 
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Table  2.8.3.2-62: 


Function  Summary  -  ammo_rock_action 
(  Region,  Symbol  ) 


Parameter 


Reaion 


Symbol 


Parameters 


Where  Tyoedef  Declared 


inter  to  OPTION  REGION  option.h 


inter  to  SYMBOL  I  svmbolif.h 


Function 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-63:  Function  Summary  -  ammo_small_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Calls  1 

Function 

Where  Described 

draw  text  label 

ODtion.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


“Small  arms” 


Table  2.8.3.2-64:  Function  Summary  -  ammo_small_action 

(  Region,  Symbol  ) 
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Table  2.8.3.2-65:  Function  Summary  •  ammo_speclJabel 
(  LimitX,  Start Yy  StartX,  Tallest  ) 


Parameter 


umitX 


SlartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


Special 


Table  2.8.3.2-66: 


Function  Summary  -  ammo_specl_action 
(  Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  I  svmbolif.h 


Function 


eneric  suopi 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-67:  Function  Summary  -  ammo_conv_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 
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Table  2.8.3.2-68:  Function  Summary  -  ammo_conv_action 

(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Region 

pointer  to  OPTION  REGION 

option.h 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Cal 

Is 

Function 

Where  Described 

this  file 

Table  2.8.3.2-69:  Function  Summary  -  generic_weapon 
(  Weapon,  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


standard 


symbolif.h 


Calls  1 

Function 

Where  Described 

mqihue 

Concurrent  graphics  library  subroutine 

mark  box 

option.c 

draw  weapon 

symdraw.c 

Table  2.8.3.2-70:  Function  Summary  -  weap_autoJabel 
(  LimitX,  StartY,  StartX,  Tallest  )~ 


Parameters 

Parameter 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 


Tallest 


inter  to  int 


inter  to  int 


standard 


standard 


Calls 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


“Automatic  intantry  weapon" 
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Table  2.8.3.2.71: 


Parameter 


Reoion 


Symbol 


Function 


eneric  weapon 


Function  Summary  >  weap_auto_action 
(  Region,  Symbol  ) 


Parameters 


Where  Tvpedef  Declared 


inter  to  OPTION  REGION  I  option. h 


inter  to  SYMBOL  I  symbolif.h 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-72:  Function  Summary  -  weap  mortarjabel 
(  LimitX,  StartY,  StartX,  Tallest  1  ~ 


Parameters 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


inter  to  int 


inter  to  int 


Where  Typedef  Declared 


standard 


standard 


standard 


standard 


1  Calls  1 

Function 

Where  Described 

draw  text  label 

option,  c 

Return  Values 


Return  Value 


draw  text  label 


Meanin 


Mortar" 


Table  2.8.3.2-73:  Function  Summary  -  weapon_mortar_action 

(  Region,  Symbol  ) 
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Table  2.8.3.2-74:  Function  Summary  -  weap  airdeMabel 
(  LimitX,  StartY,  StartX,  Tallest  f 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


“Air  defense  machine  aun 


Table  2.8.3.2-75: 


Function  Summary  -  weap_airdef_action 
(  Region,  Symbol  ) 


Parameter 


Reaion 


Symbol 


Parameters 


e  Where  Tvpedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  !  svmbolif.h 


Function 


enenc  weapon 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-76:  Function  Summary  -  weap_antit_labei 
(  LimitX,  StartY,  StartX,  Tallest  ) 
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Table  2.8.3.2-77;  Function  Summary  -  weap_antit_action 

(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Region 

pointer  to  OPTION  REGION 

option.h 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

1  Calls  1 

Function 

Where  Described 

generic  weapon 

this  file 

Table  2.8.3.2-78:  Function  Summary  -  weap_gun_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


1  Calls  1 

Function 

Where  Described 

draw  text  label 

option. c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


Gun  or  oun/howitzer" 


Table  2.8.3.2-79: 


Function  Summary  -  weap_gun_action 
(  Region,  Symbol  ) 


Parameter 


Reaion 


Symbol 


Parameters 


Where  Tvoedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  symbolif.h 


Function 


eneric  weapon 


Calls 


Where  Described 


this  file 
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Table  2.8.3.2-80:  Function  Summary  •  weap_howit_label 
(  LimitX,  StartYy  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Return  Value 


draw  text  label 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


Function 

Where  Described 

draw  text  label 

option.c 

Return  Values 


Meanln 


“Howitzer” 


Table  2.8.3.2-81:  Function  Summary  -  weap_howit_action 

(  Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Parameters 


e  Where  Tvpedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  svmbolif.h 


Function 


eneric  weapon 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-82:  Function  Summary  -  weap_antig_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 
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Table  2.8.3.2-83:  Function  Summary  -  weap_antig_action 

(  Region,  Symbol  )  ~  ~ 


Parameter 


Rea  ion 


Symbol 


Function 


eneric  weapon 


Parameters 


Where  Tvoedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  I  symbolif.h 


Calls 


Where  Described  _ 


this  file  _  _ 


Table  2.8.3.2-84:  Function  Summary  -  weap_recoil_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX* 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


1  Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


Recoilless  rifle” 


Table  2.8.3.2-85:  Function  Summary  -  weap_recoil_action 

(  Region,  Symbol  ) 
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Table  2.8.3.2-86:  Function  Summary  «  weap  airgunjabel 
(  LimitX,  StartYy  StartX,  Tallest  7 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


Calls 


Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


Gun  in  air  defense  role” 


Table  2.8.3.2-87: 


Function  Summary  -  weap_airgun_action 
(  Region,  Symbol  ) 


Parameter 


Reqion 


Symbol 


Parameters 


e  Where  Typedef  Declared 


inter  to  OPTION  REGION  I  option. h 


inter  to  SYMBOL 


svmbolif.h 


Function 


eneric  weapon 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-88:  Function  Summary  -  weap_miss_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 
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Table  2.8.3.2-89:  Function  Summary  -  weap_miss_action 

(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Reoion 

pointer  to  OPTION  REGION 

option.h 

Symbol 

pointer  to  SYMBOL 

svmbolif.h 

1  Calls  1 

Function 

Where  Described 

Generic  weapon 

this  file 

Table  2.8.3.2-90:  Function  Summary  -  weap  airmissjabel 
(  LimitX,  StartY,  StartX,  Tallest  1 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvoedef  Declared 


standard 


standard 


standard 


standard 


1  Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


“Missile  in  air  defense  role 


Table  2.8.3.2-91:  Function  Summary  -  weap  antmissjabel 
(  LimitX,  StartY,  StartX,  Tallest  1 
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Table  2.8.3.2-92:  Function  Summary  -  weap  antmissjabel 
(  LimitX,  StartY,  StartX,  Tallest  1 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tynedef  Declared 


standard 


standard 


standard 


standard 


Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


\inmm 


'fissile  in  antitank  role” 


Table  2.8.3.2-93: 


Function  Summary  -  weap_antmiss_action 
(  Region,  Symbol  )  ~ 


Parameter 


Reoion 


Symbol 


Parameters 


Where  Tvpedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  svmbolif.h 


Function 


eneric  weapon 


Calls 


Where  Described 


this  file 


Table  2.8.3.2-94:  Function  Summary  -  armor_tank_label 
(  LimitX,  StartY,  StartX,  Tallest  )~ 
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Table  2.8.3.2>95:  Function  Summary  -  armor_tank_action 

(  Region,  Symbol  ) 


1  Parameters  1 

Parameter 

Tvne 

Where  Typedef  Declared 

Region 

pointer  to  OPTION  REGION 

option. h 

Symbol 

pointer  to  SYMBOL 

svmbolif.h 

1  Calls  1 

Function 

Where  Described 

aeneric  weapon 

this  file 

Table  2.8.3.2-96:  Function  Summary  -  generic_weapsize(  Size,  Symbol  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Size 

int 

standard 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

1  Calls  1 

Function 

Where  Described 

mqihue 

Concurrent  oraphics  library  subroutine 

mark  box 

option.c 

draw  weapon 

symdraw.c 

Table  2.8.3.2-97:  Function  Summary  -  weap_light_action 

(  Region,  Symbol  ) 
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Table  2.8.3.2>98:  Function  Summary  -  weap_light_action 

(  Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Parameters 


Where  Tyoedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  I  svmbolif  .h 


Function 


moihue 


mark  box 


draw  weapon 


weap  med  action 


action 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


option.c 


raw.c 


this  file 


this  file 


Table  2.8.3.2-99:  Function  Summary  -  weap_med_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Typedef  Declared 


standard 


standard 


standard 


standard 


Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanln 


Medium 


Table  2.8.3.2-100:  Function  Summary  -  weap_med_action 

(  Region,  Symbol  ) 
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Calls 

Function  I  Where  Describe? 

generic  weapsize  I  this  file 


Table  2.8.3.2>101:  Function  Summary  •  weap_heavy_label 
(  LimitX,  StartY,  StartX,  Tallest  )~ 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

1  Return  Values  I 

Return  Value 

Meaning 

draw  text  label 

int 

“Medium” 

Table  2.8.3.2-102:  Function  Summary  -  weap_heavy_action 

(  Region,  Symbol  ) 


Parameter 


Region 


Symbol 


Parameters 


e 


inter  to  OPTION  REGION 


inter  to  SYMBOL 


Where  Tvpedef  Declared 


option.h 


svmbolif.h 


Calls 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Values 


Return  Value 


draw  text  label 


Table  2.8.3.2-103:  Function  Summary  •  done_createJabel 
(  LimitX,  StartY,  StartX,  Tallest  )” 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 
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Function 

Where  Described 

draw  text  label 

option.c 

Return  Values 


Return  Value 


draw  text  label 


Meanin 


DONE 


Table  2.8.3.2-104: 


Function  Summary  -  done_create_action 
(  Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Parameters 


e  Where  Tvoedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  svmbolif.h 


Function 


reset  reoion 


delete  window 


Calls 


Where  Described 


ODtion.c 


windows. c 


Table  2.8.3.2-105:  Function  Summary  -  next_createjabel 
(  LimitX,  StartY,  StartX,  Tallest  f 


Parameter 


LimitX 


StartY 


StartX 


Tallest 


Parameters 


inter  to  int 


inter  to  int 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


Calls 

Function 

Where  Described 

draw  text  label 

option.c 

Return  Value 


draw  text  label 


Return  Values 


Meanin 


NEXT  PAGE 


Table  2.8.3.2-106: 


Function  Summary  -  next_create_action 
(  Region,  Symbol  ) 


Parameter 


Reoion 


Symbol 


Parameters 


Where  Tvoedef  Declared 


inter  to  OPTION  REGION  option. h 


inter  to  SYMBOL  symbolif.h 
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1  Calls  1 

Function 

Where  Described 

erase  region 

option.c 

display  block 

option.c 

Table  2.8.3.2-107:  Function  Summary  -  prev_create_label 
(  LimitX,  StartY,  StartX,  Tallest  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

LimitX 

int 

standard 

StartY 

int 

standard 

StartX 

pointer  to  int 

standard 

Tallest 

pointer  to  int 

standard 

1  Calls  1 

Function 

Where  Described 

draw  text  label 

option.c 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

draw  text  label 

int 

“PREVIOUS  PAGE* 

Table  2.8.3.2-108;  Function  Summary  -  prev_create_action 

(  Region,  Symbol  )  ” 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Region 

pointer  to  OPTION  REGION 

option.h 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

1  Calls  1 

Function 

Where  Described 

erase  region 

option.c 

display  block 

option.c 

2. 8. 3. 3  symbol.c  CSU  Description  (/simnet/pvd/lib/liboverlay.a) 

This  CSU  contains  routines  for  managing  SymbolTable.  It  initializes  and  reinitializes 
SymbolTable,  allocates  space  and  inserts  symbols  and  erases  symbols  currently  active  in 
SymbolTable.  It  also  finds  and  returns  a  pointer  to  a  symbol  that  encloses  a  set  of  mouse 
coordinates,  and  displays  all  symbols  that  would  be  visible  under  the  current  zoom  level. 


Table  2.8.3.3-1:  Function  Summary  -  symboMnitQ 

This  function  initializes  the  SymTable. 
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Table  2.8.3.3-2: 


Function  Summary  -  symbol_reset() 


This^  {function  reinitializes  the  SymTable. 


Table  2.8.3.3>3:  Function  Summary  -  get_free_symbol() 

This  ifunction  allocates  space  for  SYMBOL  and  initializes  it  with  the  appropriate  defaults. 


1  Return  Values  1 

Retuirn  Value 

Meaning 

NewSymbol 

pointer  to  SYMBOL 

allocates  space  for  SYMBOL 

Table  2.8.3.3-4:  Function  Summary  -  insert_symbol(  NewSymbol  ) 
This  function  inserts  this  symbol  into  the  SymbolTable. 


1  Parameters  I 

Paratmeter 

Type 

Where  Typedef  Declared 

New&ymbol 

pointer  to  SYMBOL 

symbolif.h 

Table  2.8.3.3-5:  Function  Summary  -  draw_symbol 
(  Symbol,  Window,  Planes,  Hue  ) 

This  {function  takes  a  SYMBOL  and  draws  it.  It  examines  each  of  the  characteristic  fileds  in 
the  symbol,  Drawing  is  done  in  relative  mode  and  in  real  coordinates.  This  routine  will  be 
able  tio  write  in  color  using  the  ICON  planes  or  in  nK>nochrome  in  pop_window  planes. 


1  Parameters  I 

Paratmeter 

Type 

Where  Typedef  Declared 

SymtBOl 

pointer  to  SYMBOL 

symbolif.h 

Wincteow 

int 

standard 

Plane&s 

int 

standard 

Hue 

int 

standard 
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1  Calls  1 

Function 

Where  Described 

maiv 

Concurrent  qraphics  library  subroutine 

Concurrent  qraphics  library  subroutine 

mqihue 

Concurrent  qraphics  library  subroutine 

mqimode 

Concurrent  qraphics  library  subroutine 

calc  zoom  ratio 

new  overlay.c 

calc  basic  dim 

this  file 

draw  designation 

symdraw.c 

draw  hi  eche 

draw  size 

symdraw.c 

draw  proposed 

symdraw.c 

mqidash 

Concurrent  qraphics  library  subroutine 

draw  box 

symdraw.c 

draw  supply 

symdraw.c 

draw  branch 

symdraw.c 

draw  weapon 

symdraw.c 

draw  symtext 

symdraw.c 

Table  2.8.3.3-6:  Function  Summary  -  calc_basic_dim(  Symbol  ) 

This  function  sets  global  variables  for  drawing  routines.  Assumes  MAX_HALF_W  will  be 
less  than  POP.WINDOWS. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Table  2.8.3.3-7:  Function  Summary  •  mouse_to_symbol 
(  MouseX,  MouseY) 

This  function  fmds  and  returns  a  pointer  to  the  symbol  that  encloses  the  given  set  of  mouse 
coordinates.  If  no  symbol  encloses  them,  return  is  NULL. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

MouseX,  MouseY 

int 

standard 

IS? 

Ilujj'k!. 


Function 


rrsi 


elvcoor 


calc  zoom  ratio 


calc  basic  dim 


over  user  to  pixel 


over  point  in  box 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


new  overlay.c 


this  file 


new  overlay.c 


new  Overlay.c 
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Return  Values 


Return  Value 


NULL 


CurSymboi 


pointer  to  SYMBOL 


pointer  to  SYMBOL 


Meanln 


rmuse  clicked  outside  of  all 
svmtMls 


syrntx)!  encloses  mouse 
coordinates 


Table  2.8.3.3-8:  Function  Summary  •  erase_symbol(  Planes,  ClearHue  ) 

This  function  erases  all  the  cymbols  currently  active  in  the  symbol  table.  It  does  NOT  clear 
the  table. 


i  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Planes 

int 

standard 

ClearHue 

int 

standard 

Ca 

Is 

Function 

Where  Described 

Concurrent  oraphics  library  subroutine 

Concurrent  oraphics  library  subroutine 

calc  zoom  ratio 

new  overtay.c 

draw  symbol 

this  file 

Table  2.8.3.3-9:  Function  Summary  •  zoom_symbol 
(  Planes,  FriendHue,  FoeHue  ) 

This  function  displays  all  the  symbols  that  would  be  visible  under  the  current  zoom  level. 
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Table  2.8.3.3-10:  Function  Summary  -  copy_symbol 
(  FromSymbol,  ToSymbol  )  ~ 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

FromSymbol 

pointer  to  SYMBOL 

symbolif.h 

ToSymbol 

pointer  to  SYMBOL 

symbolif.h 

2. 8. 3. 4  symdraw.c  CSU  Description  (/simnet/pvd/lib/liboverlay.a) 

This  CSU  examines  various  fields  in  SYMBOL  and  dispatches  qjpropriate  drawing 
routines  for  them. 


Table  2.8.3.4-1:  Function  Summary  -  draw_box(  Symbol  ) 

This  function  examines  various  fields  in  SYMBOL  and  dispatches  to  the  appropriate 
drawing  routines. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

Is 

Function 

Where  Described 

draw  unit 

this  file 

add  headq 

this  file 

Table  2.8.3.4-2:  Function  Summary  •  draw_size(  Symbol  ) 
This  function  draws  the  size  symbol  on  top  of  the  basic  box. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

Is 

Function 

Where  Described 

draw  squad 

this  file 

draw  section 

this  file 

draw  platoon 

this  file 

drawjroop 

this  file 

draw  battalion 

this  file 

draw  qroup 

this  file 
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Table  2.8.3.4-3:  Function  Summary  -  draw_branch(  Symbol  ) 

This  function  draws  the  branch  inside  the  basic  box.  The  branch  could  be  the  combination 
of  two  branches,  e.g.,  INFANTRY  and  ARMOR  are  equivalent  to  “Mechanized  Infantry.” 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Cal 

Is 

Function 

Where  Described 

draw  air  def 

this  file 

draw  armor 

this  file 

draw  nbc 

this  file 

draw  cavalry 

this  file 

draw  field 

this  file 

draw  infantry 

this  file 

draw  medical 

this  file 

draw  airborne 

this  file 

draw  antitank 

this  file 

draw  aviation 

this  file 

draw  repair 

this  file 

Table  2.8.3.4-4:  Function  Summary  -  draw_hi_eche(  Symbol  ) 


This  function  draws  information  regarding  Higher  Echelons  of  command  separated  by  a 
lash.  Each  echelon  has  an  optional  size  and  branch. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

1  maimode 

Concurrent  graphics  library  subroutine 

Table  2.8.3.4>  5:  Function  Summary  •  draw_designation(  Symbol  ) 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 
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Function 


s 


imode 


Calls 


Where  Described 


Concurrent  araohics  Kbrary  subroutine 


Concurrent  araohics  fibrarv  subroutine 


Concurrent  araohics  librarv  subroutine 


Concurrent  araohics  librarv  subroutine 


Table  2.8.3.4-6: 


Function  Summary  -  draw  symtext(  Symbol,  Planes, 
Hue) 


Parameter 


Symbol 


Planes 


Hue 


Parameters 


Where  Tvoedef  Declared 


svmbolif.h 


standard 


standard 


Function 


add  free  text 


Calls 


Where  Described 


overdraw.c 


Table  2.8.3,4-7:  Function  Summary  -  draw_proposed(  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Typedef  Declared 


symbolif.h 


Function 


f 


fs 


maimode 


Calls 


Where  Described 


Concurrent  araohics  librarv  subroutine 


Concurrent  araohics  librarv  subroutine 


Concurrent  araohics  librarv  subroutine 


Concurrent  araohics  librarv  subroutine 


Table  2.8.3.4-8:  Function  Summary  •  draw_supply(  Symbol  ) 


Parameter 


Symbol 


Parameters 


enter  to  SYMBOL 


Where  Typedef  Declared 


symbolif.h 


Function 


draw  amnx) 


add  ammo  art 


add  ammo  rock 


add  ammo  small 


add  ammo  soeci 


add  ammo  conv 


Calls 


Where  Described 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 
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Table  2.8.3.4-9:  Function  Summary  -  draw_weapon(  Symbol  ) 


Parameter 


Svmbol 


Function 


draw  weao  auto 


add  hiah  travec 


add  airdef 


add  flat  travec 


add  launcher 


draw  weao  oun 


draw  weao  miss 


draw  armor  tank 


Parameters 


inter  to  SYMBOL 


Where  Tynedef  Declared 


svmbolif.h 


Calls 


Where  Described 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


this  file 


Table  2.8.3.4>10:  Function  Summary  -  draw_weapsize(  Symbol  ) 


Parameter 


Svmbol 


Function 


draw  weap  med 


draw  weao  hea 


Parameters 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


svmbolif.h 


Calls 


Where  Described 


this  file 


this  file 


Table  2.8.3.4-11:  Function  Summary  -  draw_unit(  Symbol  ) 
Draws  a  rectangle  in  relative  mode  starting  at  a  given  set  of  center  coordinates. 
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Table  2.8.3.4-12  Function  Summary  -  add_headq(  Symbol  ) 
Adds  a  staff  at  the  lower  left-hand  comer  of  the  basic  box. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

1  Calls  i 

Function 

Where  Described 

maireixy 

Concurrent  araphics  library  subroutine 

Concurrent  Graphics  library  subroutine 

1  maimode 

Concurrent  Graphics  library  subroutine 

Table  2.8.3.4-13: 

Function  Summary  -  draw_css(  Symbol  ) 

1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

Is 

Function 

Where  Described 

maireixy 

Concurrent  Graphics  library  subroutine 

Concurrent  Graphics  library  subroutine 

1  maimode 

Concurrent  araphics  library  subroutine 

Table  2.8.3.4-14:  Function  Summary  -  draw_squad(  Symbol  ) 
This  function  adds  a  squad  size  symbol. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

Is 

Function 

Where  Described 

maireixy 

Concurrent  Graphics  library  subroutine 

Concurrent  Graphics  library  subroutine 

1  mainwde 

Concurrent  Graphics  library  subroutine 

Table  2.8.3.4-15:  Function  Summary  -  draw_section(  Symbol  ) 

Parameters 

Parameter _  Type _ Where  Typedef  Declared 

Symbol _ pointer  to  SYMBOL _ svmbolif.h _ 
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Function 


ifc 


imode 


Calls 


Where  Described 


Concurrent  araohics  ybrarv  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.8.3.4-16:  Function  Summary  -  draw_platoon(  Symbol  ) 


This  function  adds  a  platoon  size  symbol. 


Parameter 


Symbol 


Function 


ifc 


imode 


Parameters 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


symbolif.h 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.8.3.4-17:  Function  Summary  -  draw_troop(  Symbol  ) 


This  function  adds  a  troop  size  symbol. 


Parameter 


Symbol 


Function 


imode 


Parameters 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


symbolif.h 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.8.3.4-18:  Function  Summary  -  draw_battalion(  Symbol  ) 
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Table  2.8.3.4-19:  Function  Summary  -  draw_group(  Symbol  ) 


Parameter 


Symbol 


Function 


I  mode 


Parameters 


inter  to  SYMBOL 


Where  Tvnedef  Declared 


symbohf.h 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.8.3.4-20:  Function  Summary  -  draw_air_def(  Symbol  ) 


Parameter 


Symbol 


Function 


ia 


imode 


Parameters 


inter  to  SYMBOL 


Where  Tvpedef  Declared 


symbolif.h 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.8.3.4-21:  Function  Summary  •  draw_armor(  Symbol  ) 


Parameter 


Symbol 


Function 


a 


imode 


Parameters 


inter  to  SYMBOL 


Where  Tvpedef  Declared 


symbolif.h 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.8.3.4-22:  Function  Summary  -  draw_nbc(  Symbol  ) 


Parameter 


Symbol 


Function 


a 


moimode 


Parameters 


inter  to  SYMBOL 


Where  Tvpedef  Declared 


symbolif.h 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 
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Table  2.8.3.4-23:  Function  Summary  -  draw_cavalry(  Symbol  ) 


Parameter 


Symbol 


Function 


imode 


Parameters 


inter  to  SYMBOL 


Where  Tyoedef  Declared 


svmbolif.h 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Table  2.8.3.4-24:  Function  Summary  •  draw_field(  Symbol  ) 


Parameter 


Symbol 


Function 


ifc 


imode 


Parameters 


inter  to  SYMBOL 


Where  Typedef  Declared 


symbolif.h 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Table  2.8.3.4-25:  Function  Summary  •  draw_infantry(  Symbol  ) 


Parameter 


Symbol 


Function 


imode 


Parameters 


inter  to  SYMBOL 


Where  Typedef  Declared 


symbolif.h 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


Table  2.8.3.4-26:  Function  Summary  -  draw_medical(  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Typedef  Declared 


symbolif.h 


Function 


il 


imode 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 
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Table  2.8.3.4-27:  Function  Summary  -  draw_airborne(  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Tyoedef  Declared 


svmbolif.h 


Function 


a 


imode 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  Kbrary  subroutine 


Table  2.8.3.4-28:  Function  Summary  -  draw_antitank(  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Tvpedef  Declared 


symbolif.h 


Function 


imode 


Calls 


Where  Described 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Table  2.8.3.4-29:  Function  Summary  •  draw_aviation(  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Tvpedef  Declared 


symbolif.h 


Function 


ifa 


mgimode 


Calls 


Where  Described 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Table  2.8.3.4-30:  Function  Summary  -  draw_repair(  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Typedef  Declared 


svmbolif.h 
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Ca 

Is 

Function 

Where  Described 

maireixv 

Concurrent  araphics  library  subroutine 

mgil 

Concurrent  araphics  fibrary  subroutine 

moia 

Concurrent  araphics  library  subroutine 

maimode 

Concurrent  araphics  library  subroutine 

Table  2.8.3.4-31:  Function  Summary  -  draw_ammo(  Symbol  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

is 

Function 

Where  Described 

maireixy 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

maipolv 

Concurrent  araphics  library  subroutine 

maimodfunc 

Concurrent  araphics  library  subroutine 

maimode 

Concurrent  araphics  library  subroutine 

Table  2.8.3.4-32:  Function  Summary  -  add_ammo_art(  Symbol  ) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

1  Calls  1 

Function 

Where  Described 

maireixy 

Concurrent  araphics  library  subroutine 

mail 

Concurrent  araphics  library  subroutine 

maimode 

Concurrent  araphics  library  subroutine 

Table  2.8.3.4-33:  Function  Summary  -  add_ammo_rock(  Symbol  ) 
This  function  is  not  implemented 


Table  2.8.3.4-34:  Function  Summary  -  add_ammo_small(  Symbol  ) 
This  function  is  not  implemented. 


Table  2.8.3.4-35:  Function  Summary  -  add_ammo_specl(  Symbol  ) 
This  function  is  not  implemented. 
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Table  2.8.3.4-36: 


Function  Summary  •  add_ammo_conv(  Symbol  ) 


This  function  is  not  implemented. 


Table  2.8.3.4-37:  Function  Summary  -  draw_weap_auto(  Symbol  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

1  Calls  1 

Function 

Where  Described 

moire  Ixy 

Concurrent  oraohics  library  subroutine 

Concurrent  oraohics  library  subroutine 

1  moimode 

Concurrent  oraohics  library  subroutine 

Table  2.8.3.4-38:  Function  Summary  -  add_high_trayec(  Symbol  ) 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

1  Calls  1 

Function 

Where  Described 

moireixy 

Concurrent  oraohics  library  subroutine 

Concurrent  oraohics  library  subroutine 

1  moimode 

Concurrent  oraohics  library  subroutine 

Table  2.8.3.4-39:  Function  Summary  -  add_airdef(  Symbol  ) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

Is 

Function 

Where  Described 

moireixy 

Concurrent  oraohics  library  subroutine 

Concurrent  oraohics  library  subroutine 

moil 

Concurrent  oraohics  library  subroutine 

moimode 

Concurrent  oraohics  library  subroutine 
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Table  2.8.3.4-40:  Function  Summary  -  add_flat_trayec(  Symbol  ) 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

Symbol 

oointer  to  SYMBOL 

svmbolif.h 

Ca 

Is 

Function 

Where  Described 

maireixv 

Concurrent  araohics  Nbrarv  subroutine 

Concurrent  araohics  Nbrarv  subroutine 

1  maimode 

Concurrent  araohics  Nbrarv  subroutine 

Table  2.8.3.4-41:  Function  Summary  -  add_launcher(  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


svmbolif.h 


Function 


I  mode 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.8.3.4-42:  Function  Summary  •  draw_weap_gun(  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


symbolif.h 


Function 


il 


■mode 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.8.3.4-43:  Function  Summary  -  draw_weap_miss(  Symbol  ) 


Parameter 


Symbol 


Parameters 


inter  to  SYMBOL 


Where  Tvoedef  Declared 


symbolif.h 


Function 


imode 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 
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Table  2.8.3.4-44:  Function  Summary  -  draw_armor_tank(  Symbol  ) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

Symbol 

pointer  to  SYMBOL 

symbolif.h 

Ca 

Is 

Function 

Where  Described 

moirelxy 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

1  moimode 

Concurrent  araphics  library  subroutine 

Table  2.8.3.4-45:  Function  Summary  -  draw_weap_med(  Symbol  ) 

This  function  is  not  implemented. 

Table  2.8.3.4-46:  Function  Summary  -  draw_weap_heavy(  Symbol  ) 
This  function  is  not  implemented. 
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2.8.4  Control  Points  CSC  Description 

This  CSC  enables  several  types  of  control  points  to  be  created.  These  include:  check, 
contact,  release/start,  coordinate,  linkup,  and  passage  points. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.8.4- 1. 


Figure  2.8.4-1:  Overlays»Control  Points  CSC  Structure. 


2.8.4. 1  controlptif.c 

This  CSU  contains  routines  for  selecting  control  points.  It  interprets  mouse  gestures  and 
invokes  appropriate  actions. 
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Table  2.8.4.1-1:  Function  Summary  -  select_controlpt(  ) 


This  function  selects  a  control  point. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

no  point  selected 

1 

int 

point  selected 

1  Calls  1 

Function 

Where  Described 

uncolor  controlpt 

this  file 

mouse  to  controlpt 

Controlpt. c 

Table  2.8.4.1-2:  Function  Summary  -  color_controlpt(point) 


This  function  draws  the  selected  point  with  SELECT_HUE. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

point 

pointer  to  SYMPT 

controlpt. h 

Cal 

Is 

Function 

Where  Described 

draw  controlpt 

Controlpt.c 

Table  2.8.4.1-3:  Function  Summary  -  uncolor_controlpt(point) 
This  function  draws  the  selected  point  with  CLEAR  hue. 


Parameters 


Parameter 


oint 


inter  to  SYMPT 


Where  Typedef  Declared 


controlot.h 


Calls 

Function 

Where  Described 

draw  controlpt 

Controlpt.c 
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Table  2.8.4.1-4:  Function  Summary  -  controlpt_check(  ) 

This  function  creates  a  check  point  icon. 


Ca 

Is 

Function 

Where  Described 

qet  free  controlot 

Controlot.c 

olace  controlot 

this  file 

insert  controlot 

Controlot.c 

Table  2.8.4.1-5:  Function  Summary  -  controlpt_coord(  ) 


Ca 

Is 

Function 

Where  Described 

qet  free  controlot 

Controlot.c 

olace  controlot 

this  file 

insert  controlot 

Controlot.c 

Table  2.8.4.1-6:  Function  Summary  -  control pt_con(  ) 


1  Calls  1 

Function 

Where  Described 

qet  free  controlot 

Controlot.c 

olace  controlot 

this  file 

insert  controlot 

Controlot.c 

Table  2.8.4. 1*7:  Function  Summary  -  controlpt_link(  ) 


Function 


et  free  controlot 


lace  controlot 


insert  controlot 


Calls 


Where  Described 


Controlot.c 


this  file 


Controlot.c 


Table  2.8.4. 1-8:  Function  Summary  -  control pt_rel(  ) 
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Table  2.8.4.1-9:  Function  Summary  -  control pt_pass(  ) 


1  Calls  1 

Function 

Where  Described 

get  free  controlpt 

Controlpt.c 

place  controlpt 

this  file 

insert  controlpt 

Controlpt.c 

Table  2.8.4.1<10:  Function  Summary  -  move_controlpt(  ) 


Ca 

Us 

Function 

Where  Described 

uncolor  controlpt 

this  file 

draw  controlpt 

Controlpt.c 

place  controlpt 

this  file 

add  free  text 

Overdraw.c 

Table  2.8.4.1-11:  Function  Summary  -  place_controlpt(point) 


Parameter 


01  nt 


Parameters 


inter  to  SYMPT 


Where  Tvpedef  Declared 


controlpt.h 


Function 


etcursmode 


icursmode 


display  cursor  loc 


mqimodfunc 


draw  controlpt 


move  mouse  hel 


etvcoor 


ixel  to  user 


default  mouse  hel 


Calls 


Where  Described 


Concurrent  Graphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Concurrent  Graphics  library  subroutine 


Controlpt.c 


Concurrent  graphics  library  subroutine 


Pvd  iface.c 


Pvd  windows.c 


Table  2.8.4.1-12:  Function  Summary  -  controlpt_delete(  ) 
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Table  2.8.4.1-13:  Function  Summary  -  controlpt_reduce(  ) 


Ca 

118 

Function 

Where  Described 

resize  mouse  help 

resize  controlpt 

this  file 

default  mouse  help 

Pvd  windows.c 

1  i  1  111!  a  III 

Overlayif.c 

Table  2.8.4.1-14:  Function  Summary  -  resize_controlpt(Flag) 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

Fiaa 

int 

standard 

Ca 

Is 

Function 

Where  Described 

uncolor  controlpt 

this  file 

draw  controlpt 

Controlpt.c 

Table  2.8.4.1-15:  Function  Summary  -  controipt_addtext(  ) 


Ca 

Is 

Function 

Where  Described 

qen  add  text 

Overtavif.c 

default  mouse  help 

Pvd  windows.c 

uncolor  controlpt 

this  file 

draw  controlpt 

Controlpt.c 

Overtavif.c 

2. 8. 4. 2  controlpt.c  CSU  Description  (/simnet/pvd/lib/liboverlay.a) 

This  CSU  contains  routines  for  managing  PointTable;  it  initializes  and  reinitializes 
PointTable.  It  selects  a  control  point,  inserts  a  point  into  PointTable,  displays  all  control 
points  that  would  be  visible  under  the  current  zoom  level,  and  erases  a  control  point. 


Table  2.8.4.2-1:  Function  Summary  -  controlpt_init() 
This  function  initializes  PointTable. 


Table  2.8.4.2-2:  Function  Summary  -  controlpt_reset() 
This  function  reinitializes  PointTable  and  frees  all  previously  allocated  points. 
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Table  2.8.4.2>3:  Function  Summary  -  mouse_to_controlpt 

(MouseX,  MouseY)  ”  ~ 

This  function  tries  to  select  a  control  point  and  returns  NULL  if  it  cannot. 


Parameter 


MouseX,  MouseY 


Parameters 


Where  Tvoedef  Declared 


standard 


Return  Value 


CurPoint 


NULL 


Return  Values 


Meanin 


controlDt  selected 


cannot  select  a  ooint 


Function 


rrsi 


etvcoor 


calc  zoom  ratio 


over  user  to  oixel 


over  DOint  in  box 


Calls 


Where  Described 


Concurrent  oraohics  library  subroutine 


Concurrent  oraohics  library  subroutine 


New  overlay.c 


New  overlay.c 


New  oyerlay.c 


Table  2.8.4.2>4  Function  Summary  -  get_free_controlpt() 
This  function  returns  a  SYMPT  structure. 


Return  Value 


01  nt 


irs 


Return  Values 


inter  to  SYMPT 


Meanin 


inter  to  SYMPT  structure 


IIS 


Table  2.8.4.2-5:  Function  Summary 
This  function  tries  to  insert  point  into  the  PointTable. 


-  insert_controipt(point) 
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Table  2.8.4.2-6:  Function  Summary  -  zoom_controlpt 
(Planes,  PenciIHue,  ClearHue) 

This  function  displays  all  the  control  points  that  would  be  visible  under  the  current  zoom 
level. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

Planes 

int 

standard 

PenciIHue 

int 

standard 

ClearHue 

int 

standard 

ca 

Is 

Function 

Where  Described 

Concurrent  oraohics  library  subroutine 

mqiqetvcoor 

Concurrent  oraohics  library  subroutine 

calc  zoom  ratio 

New  overlay.c 

draw  controlpt 

this  file 

Table  2.8.4.2-7:  Function  Summary  -  erase_controlpt(Planes,  ClearHue) 
This  function  erases  every  control  point  currendy  displayed 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

Planes 

int 

standard 

ClearHue 

int 

standard 

Ca 

Is 

Function 

Where  Described 

Concurrent  oraohics  library  subroutine 

Concurrent  oraohics  library  subroutine 

calc  zoom  ratio 

New  overlay.c 

draw  controlot 

this  file 

2. 8. 4. 3  controlptdrw.c  CSU  Description  (/simnet/pvd/lib/liboverlay.a) 

This  CSU  contains  routines  for  calculating  and  drawing  control  points. 


Table  2.8.4.3-1:  Function  Summary  -  draw  controlpt(point,  Window, 

Planes,  PenciIHue,  ClearHue) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

point 

pointer  to  SYMPT 

controlpt.h 

Window 

int 

standard 

Planes 

int 

standard 

PenciIHue 

int 

standard 

ClearHue 

int 

standard 
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Function 


calc  zoom  ratio 


draw  Dtshaoe 


draw  Dttext 


Calls 


Where  Described 


Concurrent  araohics  hbrary  subroutine 


Concurrent  oraphics  library  subroutine 


New  overlav.c 


this  file 


this  file 


Table  2.8.4.3*2:  Function  Summary  -  draw_pttext 
(point,  Planes,  PenciIHue) 


Parameter 


oint 


Planes 


PenciIHue 


Parameters 


Where  Typedef  Declared 


controlpt.h 


standard 


standard 


Function 


add  free  text 


Calls 


Where  Described 


Overdraw.c 


Table  2.8.4.3'3:  Function  Summary  -  draw  ptshape 
(point.  Planes,  PenciIHue,  ClearHue7 
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Table  2.8.4.3>4:  Function  Summary  -  draw_circlept 
(point,  PencilHue,  ClearHue) 


i  Parameters  1 

Parameter 

Where  Typedef  Declared 

ooint 

oointer  to  SYMPT 

controlpt.h 

PencilHue 

int 

standard 

ClearHue 

int 

standard 

Cal 

Is 

Function 

Where  Described 

maihue 

Concurrent  araphics  library  subroutine 

over  user  to  pixel 

New  overlay.c 

Concurrent  araohics  library  subroutine 

Table  2.8.4.3>5:  Function  Summary  -  draw_squarept 
(point,  PencilHue,  ClearHue)  ~ 


Parameters 


Parameter 


oint 


PencilHue 


ClearHue 


Where  Tvnedef  Declared 


controlot.h 


standard 


standard 


Function 


maihue 


over  user  to  oixel 


ibox 


iwidth 


iti 


Calls 


Where  Described 


Concurrent  oraDhics  library  subroutine 


New  overlay.c 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.8.4.3-6:  Function  Summary  -  draw_solidpt 
(point,  PencilHue,  ClearHue) 


m 


Parameter 


01  nt 


PencilHue 


ClearHue 


Parameters 


inter  to  SYMPT 


Where  Typedef  Declared 


controlot.h 


standard 


standard 


1  Calls 

Function 

Where  Described 

maihue 

Concurrent  araohics  library  subroutine 

over  user  to  oixel 

New  overlay.c 

llu^ 


Concurrent  araohics  library  subroutine 
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Table  2.8.4.3-7:  Function  Summary  -  add_cross 
(point,  PenciIHue,  ClearHue) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

point 

pointer  to  SYMPT 

controlpt.h 

PenciIHue 

int 

standard 

ClearHue 

int 

standard 

1  Calls  1 

Function 

Where  Described 

maihue 

Concurrent  araphics  Nbrarv  subroutine 

over  user  to  pixel 

New  overlav.c 

Corxxirrent  araphics  library  subroutine 

2.8.5  Manage  Overlays  CSC  Description 

This  CSC  provides  management  of  overlays,  including  editing,  storage  and  retrieval. 
This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.8.5- 1. 


Manage 

Overlays 

3.8.5 


over_files.c 
3.8.5. 1 


Figure  2.8.5-1:  Overlays—Manage  Overlays  CSC  Structure. 


2.8.5. 1  over_files.c  CSU  Description  (/simnet/pvd/lib/liboverlay.a) 

This  CSU  contains  routines  for  setting  path  to  overlay  directoiy,  loading  overlay  objects, 
saving  overlines  in  OverlineTable,  saving  control  points  in  PointTable,  saving  symbols  in 
SymTable,  loading  and  displaying  overlines,  loading  control  points  into  PointTable,  and 
loading  unit  symbols  into  SymTable. 
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Table  2.8.5.1-1:  Function  Summary  -  init_over_files() 
This  function  sets  the  path  to  the  overlay  directory. 


1  Calls  1 

Function 

1  Where  Described  1 

make  path  name 

init  env.c 

get  data  directory 

init  env.c 

Table  2.8.5.1-2: 

Function  Summary  -  load_overlay(fp) 

This  function  loads  all  the  overlay  objects  contained  in  file  fp. 

1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

ifi _ 

pointer  to  FILE 

stdio.h 

1  Calls  1 

Function 

Where  Described 

read  overlines 

this  file 

read  controlpts 

this  file 

read  symbols 

this  file 

Table  2.8.5.1>3:  Function  Summary  -  save_overiine(fp) 
This  function  saves  overlines  in  OverlineTable. 


! 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

fp 

pointer  to  FILE 

stdio.h 

Table  2.8.5.1*4:  Function  Summary  -  save_controlpt(fp) 
This  function  saves  control  points  in  PointTable. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

ifi _ 

pointer  to  FILE 

stdio.h 

Table  2.8.5.1-5:  Function  Summary  -  save_symbol(fp) 
This  function  saves  symbols  in  SymTable. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

fp 

pointer  to  FILE 

stdio.h 
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Table  2.8.5.1-6:  Function  Summary  -  read_overlines(fp,  num) 

This  function  loads  and  displays  overlines. 


1  Parame  ters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

fp 

pointer  to  FILE 

stdio.h 

num 

int 

standard 

1  Calls  1 

Function 

Where  Described 

aet  free  overline 

Overline.c 

insert  overline 

Overline.c 

Table  2.8.5.1-7:  Function  Summary  -  read_controlpts(fp,  num) 

This  function  loads  control  points  into  PointTable. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fp 

pointer  to  FILE 

stdio.h 

num 

int 

standard 

1  Calls  1 

Function 

Where  Described 

qef  free  confroipf 

Controlpt.c 

insert  controlpt 

Controlpt.c 

Table  2.8.5.1-8:  Function  Summary  ~  read_symbols(fp,  num) 
This  function  loads  unit  symbols  into  SymTable. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

fp 

pointer  to  FILE 

stdio.h 

num 

int 

standard 

Ca 

Is 

Function 

Where  Described 

aet  free  symbol 

symbol.c 

insert  symbol 

symbol.c 

Table  2.8.5.1-9:  Function  Summary  -  list_over_files(  ) 


This  function  lists  existing  overlay  files  on  the  screen. 
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2.9  POPUP  WINDOWS  CSC  DESCRIPTION 


This  CSC  provides  moveable  popup  windows  with  kill  boxes. 

This  CSC  functionality  is  broken  down  into  lower-level  CSCs  shown  in  Figure  2-9. 


Figure  2-9:  Popup  Windows  CSC  Structure 
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2.9.1  Initial  Popup  Windows  CSC  Description 
This  CSC  is  the  main  entry  for  Popup  Windows. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.9. 1-1. 


Initial 

Popup 

Windows 

3.9.1 


Pop_ 

windows.c 

3.9. 1.1 


init_ 

window.c 

3.9. 1.2 


Figure  2.9.1-1: 


Popup  Windows-Initial  Popup  Windows  CSC  Structure. 


2.9. 1.1  pop_windows.c 

This  CSU  manipulates  popup  windows.  It  interprets  the  user's  gestures  with  the  mouse 
and  invokes  the  appropriate  actions.  This  file  supports  movable  popup  windows  with  kill 
boxes. 

Table  2.9.1.1-1:  Function  Summary  -  pop_windows_present() 


This  function  returns  the  number  of  popup  windows  on  the  screen. 


1  Return  Values  1 

Return  Value 

Meaning 

windows.active 

int 

number  of  windows  on  screen 
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Table  2.9.1.1-2:  Function  Summary  -  init_popup() 

This  function  initializes  popup  windows. 


Ca 

is 

Function 

Where  Described 

maidefw 

Concurrent  araphics  Ubrary  subroutine 

Concurrent  araphics  library  subroutine 

1  maibank 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

maisvncrb 

Concurrent  araphics  library  subroutine 

maibbaetview 

Concurrent  araphics  library  subroutine 

dump  windows 

this  file 

Table  2.9.1.1-3:  Function  Summary  -  setup_new_window 
(title,  user_x_size,  user_y_size,  place_x,  plac'e_y, 
reai_xl,  real_yb,  real_xr,  real_yt) 

This  function  returns  a  new  window  pointer,  or  0  if  it  fails. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

title 

pointer  to  char 

standard 

int 

standard 

place  X,  place  v 

int 

standard 

real  xl,  real  yb 

float 

standard 

float 

standard 

1  Return  Values  1 

Return  Value 

Meaning 

window  ptr 

pointer  to  struct  POP  WIN 

returns  new  window  pointer 

1  Calls  1 

Function 

Where  Described 

create  window 

Pop  windows. c 

marvcoor 

Concurrent  araphics  library  subroutine 

draw  window 

I  this  file 

I 

Table  2.9.1.1>4:  Function  Summary  -  delete_ 

This  function  deletes  a  popup  window. 

window(window_ptr) 

1  Parameters  1 

Parameter 

Where  Typedef  Declared 

window  ptr 

pointer  to  struct  POP  WIN 

pop  window. h 

1  Return  Values  1 

Return  Value 

Type 

Meanina 

-1 

int 

cannot  delete  window;  all 
windows  are  free 
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Cal 

Is 

Function 

Where  Described 

erase  window 

Pop  windows.c 

dump  windows 

this  file 

Table  2.9.1.1-5:  Function  Summary  -  translate_window 
(window_ptr,  x^offset,  y_offset)  ~ 

This  function  offsets  the  internal  location  of  the  database  and  moves  the  user's  MassComp 
window. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

window  ptr 

pointer  to  struct  POP  WIN 

POP  window. r 

X  offset,  V  offset 

int 

standard 

1  Calls  1 

Function 

Where  Described 

translate  reaion 

this  file 

Concurrent  praphics  library  subroutine 

Table  2.9.1.1-6;  Function  Summary  -  translate_region(region,  x,  y) 


Parameters 


Parameter 

Type 

Where  Typedef  Declared 

region 

pointer  to  struct 

RECTANGUUR  REGION 

pop_window.h 

JLl _ 

int 

standard 

Table  2.9. 1.1-7:  Function  Summary  -  create_window(title,  user_x_size, 
user_y_size,  place_x,  place_y,  death_function) 

This  function  creates  a  popup  window. 
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Function 


check  placabilit 


maiv 


In 


maihue 


ibox 


lace  new  window 


retile  screen 


w 


dump  windows 


Calls 


Where  Described 


this  file 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


this  file 


this  file 


Concurrent  oraphics  library  subroutine 


this  file 


Table  2.9.1. 1-8:  Function  Summary  -  erase_user_box(window_ptr) 


This  function  sets  the  user  portion  of  the  window  to  background  color. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

window  ptr 

pointer  to  struct  POP  WIN 

pop  window. h 

1  Calls  1 

Function 

Where  Described 

moiv 

Concurrent  oraphics  library  subroutine 

Concurrent  oraphics  library  subroutine 

1  mqibox 

Concurrent  oraphics  library  subroutine 

Table  2.9.1J-9:  Function  Summary  -  erase_window(window_ptr) 
This  function  erases  a  popup  window. 
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Table  2.9.1.1-10:  Function  Summary  -  big_font_data(height,  width, 

offset,  hpad,  vpad) 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

height 

pointer  to  int 

standard 

width 

pointer  to  int 

standard 

offfset 

pointer  to  int 

standard 

hpad 

pointer  to  int 

standard 

vpad 

pointer  to  int 

standard 

1  Calls  1 

Function 

Where  Described 

maioetofinfo 

Concurrent  graphics  library  subroutine 

Table  2.9.1.1-11: 

Function  Summary  -  draw_window(window_ptr) 

1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

window  ptr 

pointer  to  struct  POP  WIN 

POP  window. h 

Ca 

Is 

Function 

Where  Described 

mgiv 

Concurrent  graphics  library  subroutine 

Concurrer^  araphics  library  subroutine 

mgihue 

Concurrent  graphics  library  subroutine 

mgibox 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

big  font  data 

this  file 

mgigf 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

Table  2.9.1.1-12:  Function  Summary  -  copy_array(from,  to,  num  longs) 

This  function  copies  arrays. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

from 

array  of  int 

standard 

to 

array  of  int 

standard 

num  longs 

int 

standard 
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Table  2.9.1.1-13:  Function  Summary  -  get_window_num(window_ptr) 


This  function  maps  a  window  pointer  into  a  MassComp  window  number. 


Parameter 


window  Dtr 


Parameters 


inter  to  struct  POP  WIN 


Where  Typedef  Declared 


window.h 


Return  Values 


Return  Value  I  Tyne 


window  ptr->window  num  i  int 


Meanin 


window  number 


Table  2.9.1.1-14:  Function  Summary  -  handle_popup_windows(mouse) 

This  function  returns  1  if  the  mouse  still  needs  to  be  handled,  0  if  successfully  handled 
here. 


Parameter 


Parameters 


pointer  to  struct 
MOUSE  EVENT 


Where  Typedef  Declared 


pvdjiags.h 


Return  Values 


Return  Value 


Meanin 


mouse  handled  here 


mouse  still  needs  to  be 
handled 


Function 


oint  in  box 


move  pop  window 


Calls 


Where  Described 


this  file 


this  file 


Table  2.9.1.1-15:  Function  Summary  -  point_in_box(x,  y,  box) 
This  function  returns  1  if  the  passed  point  is  in  the  indicated  box. 


Parameter 


Parameters 


e 


int 


pointer  to  struct 
RECTANGULAR  REGION 


Return  Values 


Return  Value 


Where  Typedef  Declared 


standard 


pop_window.h 


Meanin 
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Table  2.9.1.1-16:  Function  Summary  -  move_pop_window 
(win,  initiai_x,  initial_y) 

This  function  moves  popup  windows  by  copying  via  the  back  frame  buffer. 


Parameter 


win 


initial  x,  initial 


Parameters 


Where  Tynedef  Declared 


window,  h 


standard 


Function 


imodfunc 


In 


moihue 


offset  box 


check  placabilit 


move  via  back  fb 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


this  file 


Concurrent  araphics  library  subroutine 


this  file 


this  file 


Table  2.9.1.1-17:  Function  Summary  -  check_placability 
(x,  y,  x_minus,  y_minus,  x_plus,  y_plus,  win) 

This  function  returns  1  if  a  window  may  be  placed  at  the  passed  location. 
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Table  2.9.1.1-18;  Function  Summary  -  offset_box 
(x,  y,  minus_Xy  minus_y,  plus_x,  plus_y) 


This  function  draws  a  box  relative  to  the  passed  point 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

JLJf 

int 

standard 

int 

standard 

1  plus  X,  plus  V 

int 

standard 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  araphics  library  subroutine 

Table  2.9.1.1-19: 

Function  Summary  -  box_overlaps_window 
(xl,  yb,  xr,  yt,  win) 

1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

■  III  II II 

int 

standard 

1  win 

pointer  to  struct  POP  WIN 

pop  window. h 

1  Return  Values  1 

Return  Value 

Type 

Meanlna 

1 

int 

box  overlaps  window 

0 

int 

box  does  not  overlap  window 

I  Calls  I 

Function 

i  Where  Described  1 

point  in  box 

i  this  file 

1 

Table  2.9.1.1-20: 

Function  Summary  -  move_via_back_fb 
(win,  x_offset,  y_offset) 

This  function  relocates  a  window.  The  old  location  of  the  window  is  erased,  and 
underlying  windows  are  not  repainted. 

1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

win 

pointer  to  struct  POP  WIN 

POP  window. h 

X  offset,  V  offset 

int 

standard 
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Function 


nonmao  back 


ibank 


IV 


In 


iaetfb 


ifb 


erase  window 


ibblt2 


translate  window 


lanes  back 


EH! 

iul«lg 

E? 

E!* 


Calls 


Where  Described 


New  zoom.c 


Concurrent  oraphics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  sraphics  library  subroutine 


Concurrent  graphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


this  file 


Concurrent  oraphics  library  subroutine 


this  file 


this  file 


Table  2.9.1.1-21:  Function  Summary  -  copy_planes_back(plane_mask) 


Parameters 


Parameter 


lane  mask 


Where  Typedef  Declared 


standard 


1  Calls  1 

Function 

Where  Described 

mqibank 

Concurrent  oraphics  library  subroutine 

mqiv 

Concurrent  oraphics  library  subroutine 

etfb 


mqisyncrb 


moibblt2 


moifbfbex 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2.9.1.1-22:  Function  Summary  -  place_new_window 

(x,  y,  width,  height) 


This  function  finds  an  acceptable  place  for  a  new  window  of  the  passed  size.  It  first  scans 
the  screen  in  WINDOW_STEP  increments.  If  it  fails  to  find  a  place,  it  retiles  the  screen 
and  tries  again. 
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Table  2.9.1.1-23:  Function  Summary  -  retile_screen() 

This  function  sorts  the  windows  on  the  screen  by  area  and  rearranges  them  so  as  to  allow 
maximum  area  for  new  windows. 


Ca 

Is 

Function 

Where  Described 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  Ubrary  subroutine 

1  mqibank 

Concurrent  araphics  library  subroutine 

liil  II  1  111 

Concurrent  araphics  library  subroutine 

this  file 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

place  new  window 

this  file 

mgibblt2 

Concurrent  araphics  library  subroutine 

translate  window 

this  file 

Table  2.9.1.1-24:  Function  Summary  -  dump  windowsO 
This  function  prints  out  the  current  window  structure  on  standard  out. 


2.9. 1.2  init_window.c 

This  CSU  sets  up  the  three  colors  available  to  the  window  system. 


Table  2.9.1.2-1:  Function  Summary  -  init_window_colors() 
This  function  sets  up  the  three  colors  available  to  the  window  system. 


1  Calls  1 

Function 

Where  Described 

make  color  mao 

Color  map.c 
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2.9.2  Manage  Popup  Windows  CSC  Description 

This  CSC  manages  popup  windows,  which  are  used  to  contain  certain  menu  options. 
This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.9.2- 1. 


Manage 

Popup 

Windows 

3.9.2 


plol_box.c 

3.9.2.1 


help.c 

3.9.2.2 


error_ 

box.c 

3.9.2.3 

option.c 

3.9.2.4 


Figure  2.9.2-1:  Popup  Windows-Manage  Popup  Windows  CSC  Structure. 


2. 9. 2.1  plot_box.c 

This  CSU  sets  up  a  plotting  window,  with  axes. 


BBN  Systems  and  Technologies 


Plan  View  Display  CSQ 


Table  2.9.2.1-1:  Function  Summary  -  plot_box 
(window,  back_color,  pen_color,  place,  margins,  axises, 
homogeneous,  x_tic,'’ y_tic,  x_label,  y_label) 

This  function  sets  up  a  plotting  window,  with  axes.  It  assumes  a  window  has  been  defmed 
but  not  placed 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

window 

int 

standard 

back  color 

int 

standard 

pen  color 

int 

standard 

place 

pointer  to  struct  int  quad 

this  file 

ma  rains 

pointer  to  struct  quad 

this  file 

axises 

pointer  to  struct  quad 

this 

homoaeneous 

int 

standard 

float 

standard 

1 X  label.  V  label 

pointer  to  char 

standard 

Ca 

Is 

Function 

Where  Described 

mqrvcoor 

Concurrent  qraphics  library  subroutine 

mqiv 

Concurrent  qraphics  library  subroutine 

mqihue 

Concurrent  qraphics  library  subroutine 

mqibox 

Concurrent  qraphics  library  subroutine 

mqrl 

Concurrent  qraphics  library  subroutine 

mqrl1 

Concurrent  qraphics  library  subroutine 

label  point 

mqisyncrb 

Concurrent  qraphics  library  subroutine 

2. 9. 2. 2  help.c 

This  CSU  displays  and  removes  a  pK)pup  window  for  displaying  Help  information  on  the 
screen. 


Table  2.9.2.2-1:  Function  Summary  -  helpO 
This  function  displays  the  contents  of  an  ascii  file  in  the  help  window. 


Ca 

Is 

Function 

Where  Described 

help  menu  entry  on 

Edit  menu.c 

delete  window 

Pop  windows.c 

create  window 

Pop  windows.c 

qet  window  num 

Pop  windows.c 

make  path  name 

Init  env.c 

qet  data  directory 

Init  fciv.c 

display  window  text 

this  file 

help  menu  entry  off 

Edit  menu.c 
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Table  2.9.2.2-2:  Function  Summary  -  kilI_heIp_wlndow() 
This  function  deletes  the  help  window. 


Function 


helD  menu  entry  on 


delete  window 


Calls 


Where  Described 


Edit  menu.c 


Poo  windows.c 


Table  2.9.2.2-3:  Function  Summary  -  display_window_text 
(text_file,  title,  window) 

This  function  displays  text  in  the  help  window.  It  first  opens  the  text  file,  then  replaces  the 
window  to  fit  the  text. 


Parameter 


text  file 


title 


window 


Parameters 


e 


inter  to  char 


inter  to  char 


inter  to  struct  POP  WIN 


Where  Tvoedef  Declared 


standard 


standard 


window. h 


Calls  1 

Function 

Where  Described 

find  max  chars 

this  file 

etvcoor 


et  window  num 


draw  window 


In 


maihue 


f 


s 


strip  char 


Concurrent  oraphics  library  subroutine 


Poo  windows.c 


Pop  windows.c 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


this  file 


Table  2.9.2.2-4:  Function  Summary  -  display_window_string 
(msg_text,  window,  ignore_nl) 

This  function  prints  the  specified  string  in  the  specified  window. 
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Ca 

Is 

Function 

Where  Described 

Concurrent  graphics  library  subroutine 

1  draw  window 

Pop  windows.c 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

1  mgihue 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

Table  2.9.2.2-5'  Function  Summary  -  stnp_char(string,  character) 
This  function  removes  any  single  type  of  character  from  a  string. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

string 

pointer  to  char 

standard 

character 

point  to  char 

standard 

Table  2.9.2.2-6:  Function  Summary  -  find_max_chars(fp) 
This  function  finds  the  maximum  width  of  an  open  file,  including  tabs,  etc. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

J£ _ 

pointer  to  FILE 

stdio.h 

1  Calls  1 

Function 

Where  Described 

check  help 

help  menu  entry  on 

Edit  menu.c 

2. 9. 2. 3  errorbox.c 

This  CSU  displays  and  removes  error  messages  in  a  popup  window  on  the  screen. 


Table  2.9.2.3-1:  Function  Summary  -  error_box(text_file,  error_title) 
This  function  puts  an  error  message  on  the  screen  in  a  popup  window. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

text  file 

pointer  to  char 

standard 

error  title 

pointer  to  char 

standard 
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Return  Value 


-1 


Return  Values 


Meanin 


cani  open  error  window; 
already  exists 


Calls  1 

Function 

Where  Described 

create  window 

Pop  windows.c 

make  oath  name 

Init  env.c 

et  data  di  recto 


display  window  text 


Init  env.c 


Help.c 


Table  2.9.2.3-2:  Function  Summary  -  kiII_error_window() 

This  function  removes  an  error  popup  window  from  the  screen. 

Calls 

Function  I  Where  Described 

delete  window  Pop  windows.c 


Table  2.9.2.3-3:  Function  Summary  -  error_window_exists() 


1  Return  Values  1 

Return  Value 

Type  1  Meaning 

error  window  !=  0 

int  I  error  window  exists 

Table  2.9.2.3-4:  Function  Summary  -  check_error_window() 
This  function  checks  whether  an  error  window  exists. 


Cal 

Is 

Function 

Where  Described 

error  window  exists 

this  file 

kill  error  window 

this  file 

Table  2.9.2.3-5;  Function  Summary  -  string_error_box 
(message_text,  window_titie) 


This  function  puts  an  error  message  on  the  screen  in  a  popup  window,  taking  a  string 
argument  for  the  message  text  and  allowing  specification  of  the  window  bar  tide. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

message  text 

pointer  to  char 

standard 

window  title 

pointer  to  char 

standard 
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i  Return  Values  1 

Return  Value 

-1 

int 

error  window  exists  I 

I _ Calls _ I 

Function 

Where  Described 

create  window 

Pop  windows.c 

display  window  string 

Help.c 

2. 9. 2. 4  option.c 

This  CSU  contains  routines  for  defining  regions  within  the  popup  window,  displaying 
options  labels  with  corresponding  select  boxes,  and  for  providing  for  nnouse  selection  of 
options. 


Table  2.9.2.4-1:  Function  Summary  -  option_reg_define 
(PopWindow,  XI,  Yb,  Xr,  Yt) 

This  function  defines  a  region  within  a  popup  window  in  which  to  display  input  options. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

PopWindow 

pointer  to  struct  POP  WIN 

pop  window. h 

XI.  Yb.  Xr.  Yt 

int 

standard 

I  Return  Values  ! 

Return  Value 

Type 

Meaning 

OptionRegion 

pointer  to  struct 

OPTION  REGION 

set  up  option  with  no  options 
blocks  defined  or  displayed 

Table  2.9.2.4-2:  Function  Summary  -  define_block 
(OptionRegion,  OptionList,  Title) 

This  function  takes  a  previously  defined  OptionRegion,  a  list  of  options,  and  a  title  string 
and  returns  a  relocatable  option  block  if  it  fits  in  the  given  OptionRegion. 


i  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

OptionRegion 

pointer  to  struct 

OPTION  REGION 

option. h 

OptionList 

pointer  to  stmct  OPTION 

option. h 

Title 

pointer  to  char 

standard 

I  Return  Values  1 

Return  Value 

Meaning 

NULL 

int 

block  too  big  for  this  region 

OptionBlock 

pointer  to  struct 

OPTION  BLOCK 

option  block  successfully 
defined 
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Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Pod  windows.c 


Table  2.9.2.4-3:  Function  Summary  -  display_block 
(OptionRegion,  OptionBlock) 

This  function  displays  a  previously  defined  block.  It  activates  the  block  and  displays  the 
option  labels  with  their  corresponding  select  boxes. 


Parameter 


OptionRegion 


OptionBlock 


Return  Value 


0 


OptionRegion  ->  FreeYLine 
OptionReoion  ->  Area.vb 


Function 


et  window  num 


In 


mqihue 


display  title 


mark  box 


Parameters 


e 


pointer  to  struct 
OPTION  REGION 


pointer  to  struct 
OPTION  BLOCK 


Return  Values 


Where  Typedef  Declared 


option. h 


option. h 


Meanin 


not  enough  room  left  for  block 


height  in  number  of  pixels  left  in 
this  input  region 


Calls 


Where  Described 


Concurrent  graphics  library  subroutine 


Pop  windows.c _ 

Concurrent  oraphics  library  subroutine 


Concurrent  graphics  library  subroutine 


this  file 


this  file 


Table  2.9.2.4-4:  Function  Summary  -  erase_block 
(OptionRegion,  OptionBlock) 

This  function  erases  the  area  corresopnding  to  the  width  of  the  option  region  and  the  height 
of  the  given  OptionBlock,  including  title.  It  also  deactivates  the  block. 


349 


BBN  Systems  and  Technologies 


Plan  View  Display  CSCI 


Function 


et  window  num 


In 


maihue 


ibox 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


Pop  windows.c 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Concurrent  araohics  library  subroutine 


Table  2.9.2.4-5:  Function  Summary  -  display_title 
(OptionRegion,  OptionBIock)  ~ 

This  function  displays  the  title  corresponding  to  the  given  option  block  on  top  center  of  the 
already  display  labels. 


Parameter 


OptionRegion 


OptionBIock 


Parameters 


e 


pointer  to  struct 
OPTION  REGK^I 


pointer  to  struct 
OPTION  BLOCK 


Where  Typedef  Declared 


option. h 


option,  h 


Function 


et  window  num 


In 


maihue 


t 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Pop  windows.c 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Table  2.9.2.4-6:  Function  Summary  -  mouse_to_option 
(OptionRegion,  PosX,  PosY) 

This  function  returns  the  option  displayed  closest  to  coordinates  PosX,  PosY. 


Parameter 


OptionRegion 


PosX.  PosY 


Parameters 


e 


pointer  to  stmct 
OPTION  REGION 


int 


Where  Typedef  Declared 


option. h 


standard 


Return  Value 


NULL 


MinOption 


Return  Values 


pointer  to  stmct  OPTION 


pointer  to  struct  OPTION 


Meanin 


coordinates  do  not  correspond 
to  a  yalid  option 


looks  through  all  active  option 
blocks  to  find  one  that  encloses 
the  chosen  option 
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Table  2.9.2.4-7:  Function  Summary  -  draw^text  label 
(Text,  Font,  LimitX,  Start Y,  StartX,  T^llestf 

This  function  draws  a  select  box  and  the  label  Text  to  the  right  of  the  box. 


Parameters 


Parameter 


Text 


FontNum 


LimitX,  StartY 


StartX,  Tallest 


Return  Value 


inter  to  int 


Return  Values 


Where  Typedef  Declared 


standard 


standard 


standard 


standard 


Meanin 


cannot  draw  box  and  text 
startino  at  StartX  within  LimitX 


can  draw  box  and  text 


Function 


etafinfo 


draw  select  box 


f 


s 


Calls 


Where  Described 


Concurrent  araohics  library  subroutine 


this  file 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


Table  2,9.2.4-8:  Function  Summary  -  display_from_blk 
(OptionRegion,  StartBlock) 

This  function  displays  as  many  blocks  as  it  can,  starting  with  StartBlock,  until  it  cannot  fit 
any  more  or  until  it  has  displayed  all  teh  blocks  after  StartBlock. 
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Table  2.9.2.4>9:  Function  Summary  -  erase_region(OptionRegion) 

This  function  deletes  all  the  blocks  currently  being  displayed.  It  does  not  reset  the  options 
in  the  region. 


1  Parameters  1 

Parameter 

Type 

Where  Tvpedef  Declared 

OptionRegion 

pointer  to  stmct 

OPTION  REGION 

option.h 

1  Calls  1 

Function 

Where  Described 

erase  block 

this  file 

Table  2.9.2.4-10:  Function  Summary  -  reset_region(OptionRegion) 

This  function  is  called  when  the  region  is  no  lunger  used;  it  unselects  all  options. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

OptionRegion 

pointer  to  struct 

OPTION  REGION 

option.h 

1  Calls  i 

Function 

Where  Described 

erase  region 

this  file 

Table  2.9.2.4-11:  Function  Summary  -  draw_select_box 
(LimitX,  StartXy  StartY)  ~ 

This  function  draws  a  box  with  coordinates  StartX,  StartY  as  the  upper  left  comer. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

LimitX 

int 

standard 

StartX.  StartY 

int 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

width  of  box  larger  than  LimitX 

BOX  WIDTH 

int 

width  of  box 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  graphics  library  subroutine 
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2.10  TOOLS  CSC  DESCRIPTION 


This  CSC  provides  map  tools  that  include  ruler,  intervisibility  options,  and  terrain  cross- 
section. 

This  CSC  functionality  is  broken  down  into  lower-level  CSCs  shown  in  Figure  2-10. 


Figure  2-10:  Tools  CSC  Structure. 
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2.10.1  Ruler  CSC  Description 

This  CSC  measures  the  distance  between  locations. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.10.1-1. 


Ruler 

3.10.1 


ruler.c 

3.10.1 


Figure  2.10.1-1:  Tools-Ruler  CSC  Structure. 


2.10.1.1  ruler.c 

This  CSU  suppons  measuring  distances  on  the  map. 


Table  2.10.1.1-1:  Function  Summary  -  text_ruler(x0,  yO,  xl,  yl) 
This  function  displays  the  distance  in  meters  between  two  passed  points. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

xO.  vO 

int 

standard 

xl.vl 

int 

standard 

Ca 

Is 

Function 

Where  Described 

maiunscalexv 

Concurrent  araphics  library  subroutine 

Concurrent  araphics  library  subroutine 

maiv 

Concurrent  araphics  library  subroutine 

maihue 

Concurrent  araphics  library  subroutine 

maifc 

Concurrent  araphics  library  subroutine 
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2.10.2  Intervisibility  CSC  Description 


This  CSC  performs  several  types  of  intervisibility  calculations  based  on  user-supplied 
input.  Types  of  intervisibility  are  area  from  point,  point  to  vehicle,  vehicle  to  vehicle,  and 
point  to  point.  This  CSC  also  calculates  intervisibihty  to  enemy  vehicles.  It  uses  target  and 
view  heights  and  view  range  as  inputs. 


This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.10.2-1. 


Inter- 

Visibility 

3.10.2 


ibcheckvis.a 

3.10.2.1 

vehicle_ 

to_v.c 

3.10.2.2 

get_elev.c 

3.10.2.3 


get_view.c 


3.10.2.4 
intervis.c 

3.10.2.5 


clipper 

3.10.2.6 


Figure  2.10.2-1:  Tools — Intervisibility  CSC  Structure. 


2.10.2.1  libcheckvis.a  CSU  Description  (/simnet/lib) 

This  library  supports  intervisibility  calculations.  It  is  documented  in  "Vehicles  CSCI 
Software  Design  Document." 

2.10.2.2  vehicle  to  v.c 


This  CSU  manages  startup  and  shutdown  of  vehicle  to  vehicle  intervisibility  tagged  to  a 
moving  vehicle.  It  updates  intervisibility  lines. 
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Table  2.10.2.2-1:  Function  Summary  -  do_vehicIe_to_vehicle 

(selected_vehicles)  ~ 

This  function  handles  startup  or  shutdown  of  vehicle  to  vehicle  intervisibility  tagged  to  a 
moving  vehicle. 


Parameter 


selected  vehicles 


Parameters 


SELECTED  VEHICLES 


Where  Tvnedef  Declared 


select.h 


Function 


erase  ravs 


encode  force 


intervis  vehicles 


et  world  state 


et  view  heiaht 


et  taroet  heioht 


Calls 


Where  Described 


this  file 


this  file 


Intervis.c 


Get  view.c 


Get  view.c 


Table  2.10.2.2-2: 


Parameter 


current  time 


Function  Summary  -  update_vehicIe_to_vehicIe 
(current_time) 


Parameters 


Where  Typedef  Declared 


standard 


Calls 

Function 

Where  Described 

erase  rays 

this  file 

encode  force 

this  file 

intervis  vehicles 

Intervis.c 

et  view  heiaht 


et  taraet  heiaht 


Get  view.c 


Get  View.c 


Table  2.10.2.2-3:  Function  Summary  -  erase_rays(orgin,  num_rays,  ends) 


Parameters 


Parameter 


orain 


num  ravs 


ends 


inter  to  POINT 


mt 


array  of  POINT 


Where  Typedef  Declared 


V  vis.h 


standard 


V  vis.h 


Function 


IV 


maihue 


In 


Calls 


Where  Described 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 


Concurrent  araphics  library  subroutine 
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Table  2.10.2.2-4:  Function  Summary  -  get_tags() 


1  Return  Values  1 

Return  Value 

Meaning 

tags 

pionter  to  stmct 

V  V  VISIBILITY 

local  static  variable 

Table  2.10.2.2-5:  Function  Summary  -  set_tags(new_tags) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

newjags 

pointer  to  struct 

V  V  VISIBILITY 

v_vis.h 

Table  2.10.2.2-6:  Function  Summary  -  clear_aIl_veh_to_veh() 
This  function  turns  off  vehicle  to  vehicle  intervisibility  for  all  vehicles. 


1  Calls  1 

Function 

Where  Described 

erase,  rays 

this  file 

Table  2.10.2.2-7:  Function  Summary  -  encode_force(force) 


This  function  returns  the  forces  to  view  given  that  user  is  of  the  passed  force. 


j  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

force 

int 

standard 

1  Return  Values  1 

Return  Value 

Meaning 

OxA 

int 

distinguishedForcelD 

0x9 

int 

otherForcelD 

0x8 

int 

observerForcelD 

0x3 

int 

taroetForcelD 

OxF 

int 

default  ALL  VEHICLES 

Table  2.10.2.2-8:  Function  Summary  -  view_all_align() 
This  function  assigns  visibility  mode  to  ALL_VEHICLES. 


Table  2.10.2.2-9:  Function  Summary  -  view_opposing_align() 
This  function  assigns  visibility  mode  to  OPPOSING_VEHICLES. 
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2.10.2.3  get_elev.c 

This  CSU  returns  elevation  in  meters  of  any  point  on  the  map. 


Table  2.10.2.3-1:  Function  Summary  -  get_elevation(x,  y) 
This  function  returns  the  elevation  in  meters  of  any  point  on  the  map. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

hi _ 

float 

standard 

1  Return  Values  1 

Return  Value 

Type 

Meanlna 

0.0 

float 

error 

location.z 

float 

returns  location 

1  Calls  1 

Function 

Where  Described 

tdb  aet  z 

see  libtdb  in  MCC  CSCI 

tdb  error 

see  libtdb  in  MCC  CSCI 

2.10.2.4  get_view.c 

This  CSU  gets  the  height  of  the  top  of  the  target  vehicle  above  the  ground. 

Table  2.10.2.4-1: 

Function  Summary  -  get__view_^height() 

1  Return  Values  I 

Return  Value 

Type 

Meanlna 

view_height 

float 

returns  height  of  eye  level 
above  ground 

Table  2.10.2.4-2:  Function  Summary  -  get_target_height() 


1  Return  Values  I 

Return  Value 

Type 

Meanlna 

target_height 

float 

returns  height  of  top  of  target 
vehicle  above  ground 

Table  2.10.2.4-3:  Function  Summary  -  set_view_height(height) 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

height 

float 

standard 
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Table  2.10.2.4-4:  Function  Summary  -  set_target_height(height) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

heiqht 

float 

standard 

Table  2.10.2.4-5:  Function  Summary  -  set_view_range(range) 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

ranae 

float 

standard 

Table  2.10.2.4-6: 

Function  Summary  -  get_view_range() 

1  Return  Values  I 

Return  Value 

Type 

Meaninq 

view  ranqe 

float 

returns  maximum  visibility  ranqe 

2.10.2.5  intervis.c 

This  CSU  supports  the  various  intervisibility  menu  options. 


Table  2.10.2.5-1:  Function  Summary  -  intervisibiiity(from_x,  from_y, 
to_x,  to _y,  view_helght,  target_height) 

This  function  determines  intervisibility  between  two  points,  using  straight  line  (not 
segmented)  visibility.  The  result  is  printed  in  the  info  window  ("Not  visible,"  etc.)  and  a 
line  segment  of  the  appropriate  color  is  drawn  on  the  map. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

int 

standard 

to  X.  to  V 

int 

standard 

view  heiqht 

float 

standard 

tarqet  heiqht 

float 

standard 

Ca 

Is 

Function 

Where  Described 

mqiunscalexv 

Concurrent  Graphics  library  subroutine 

pve  checkvis 

Concurrent  Graphics  library  subroutine 

Concurrent  Graphics  library  subroutine 

set  ray  color 

this  file 

print  visibility  code 

this  file 

nxjrl 

Concurrent  Graphics  library  subroutine 

draw  X 

this  file 
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Table  2.10.2.5*2:  Function  Summary  -  initjntervisibility 
This  function  initializes  the  intervisibility  function. 


Function 


et  patch  auards 


Calls 


Where  Described 


IMiKAUJu 


view  heiaht 


tarqet  heiaht 


standard 


standard 


standard 


standard 


Function 


mqiunscalex 


et  elevation 


ve  checKvis 


rint  visibility  code 


Calls 


Where  Described 


Concurrent  qraphics  library  subroutine 


Get  elev.c 


Concurrent  qraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


this  file 


set  ray  color 

this  file 

draw  X 

this  file 

draw  coded  line 

this  file 

Table  2.10.2.5-4:  Function  Summary  -  draw  coded  line 
(segments,  num_segments,  final_x,  final  y) 
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Table  2.10.2.5-5:  Function  Summary  -  set_ray_coIor  (visibiIity_code) 


This  function  sets  the  default  color  to  the  t^propriate  one  for  the  visibility  code. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

visibility  code 

int 

standard 

Ca 

Is 

Function 

Where  Described 

mqihue 

Concurrent  araphics  library  subroutine 

Table  2.10.2.5-6:  Function  Summary  -  intervis_369 
(from_x,  from  y,  num_rays,  max_range, 
view_heTght,  target_height) 

This  function  draws  intervisibility  lines  out  from  the  passed  point  to  points  on  a  circle  of 
radius  3500  meters.  The  lines  show  the  possibility  of  seeing  an  object  ”target_height" 
above  the  ground. 
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Table  2.10.2.5-7:  Function  Summary  -  reaMntervis_360(from_x,  from_y, 
num_rays,  max_range,  view_height,  targ^_height) 

This  function  draws  area  intervisibility  rays  out  from  the  passed  point.  The  lines  show  the 
possibility  of  seeing  an  object's  "target_height"  above  the  ground. 


Parameters 


Parameter 


num  rays 


max  ranae 


view  heiQht 


taroet  heiaht 


Where  Tvpedef  Declared 


standard 


standard 


standard 


standard 


standard 


Function 


et  catch  ouards 


II? 

Ins? 

I? 


rrst 


et  elevation 


maiv 


In 


ve  checkvis 


draw  coded  line 


Calls 


Where  Described 


Concurrent  oraphics  library  subroutine 


Concurrent  qraphics  library  subroutine 


Get  elev.c 


Concurrent  oraphics  library  subroutine 


Concurrent  oraphics  library  subroutine 


this  file 


Table  2.10.2.5-8:  Function  Summary  -  intervis_vehicles  (from_xm, 
from_ym,  from_zm,  worid_sta(e,  view_helght, 

Target_height,  slde_code,  tags,  print) 

This  function  draws  intervisibility  lines  from  the  selected  point  to  all  existing  vehicles.  The 
view  height  is  relative  to  the  vehicle's  coordinate  origin. 
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Table  2.10.2.5-9:  Function  Summary  -  emb_attenuate 
(from_x,  from_y,  to_y,  view_height,  targeF_height) 


This  function  determines  intervisibility  between  two  points,  using  straight  line  (not 
segmented)  visibility.  The  result  is  printed  in  the  info  window  ("Not  visible,"  etc.)  and  a 
line  segment  of  the  appropriate  color  is  drawn  on  the  map. 


1  Parameters  1 

1  Parameter 

Type 

Where  Typedef  Declared 

int 

standard 

to  X,  to  V 

int 

standard 

view  heiqht 

float 

standard 

taraet  heiaht 

float 

standard 

1  Ca 

Is 

f  Function 

Where  Described 

i  l|i|  1 1 1 II 1 

Concurrent  graphics  library  subroutine 

get  elevation 

Get  elev.c 

pve  checkvis 

Concurrent  graphics  library  subroutine 

Concurrent  graphics  library  subroutine 

set  ray  color 

this  file 

print  visibility  code 

this  file 

marl 

Concurrent  graphics  library  subroutine 

draw  X 

this  file 

attenuation  factor 

this  file 

Table  2.10.2.5-10:  Function  Summary  -  draw_x(x,  y) 
This  function  marks  a  spot  with  an  x. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

JLl _ 

int 

standard 

1  Calls  1 

1  Function 

Where  Described 

Concurrent  graphics  library 
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Table  2.10.2.5-11: 


Function  Summary  -  attenuation_factor 
(distance,  frequency) 


This  function  computes  the  attenuation  factor  for  radio  transmissions  partially  blocked  by 
terrain. 


1  Parameters  1 

Parameter 

Where  Tvpedef  Declared 

distance,  frequency 

double 

standard 

1  Return  Values  1 

Return  Value 

Meanina 

1.0 

static  double 

wavelength  too  close;  distance 
too  small 

4.0  +  distance  *  195 

static  double 

distance  <  .01 

5.12  -1- distance  *  83.5 

static  double 

distance  <  .09 

5.86  +  distance  *  75.23 

static  double 

distance  <1.0 

2.47  +  distance  ‘  78.629 

Table  2.10.2.5-12:  Function  Summary  -  print_visibility_code 

(fp,  visibility_code)  ~ 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

tP 

pointer  to  FILE 

stdio.h 

visibility  code 

int 

standard 

2.10.2.6  clipper.c 

This  CSU  contains  routines  for  determining  the  clipping  edges  of  a  map. 


Table  2.10.2.6-1:  Function  Summary  -  clip_to_map(inside_pt,  test_pt) 


i  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

inside  pt 

array  ot  double 

standard 

test  pt 

array  ot  double 

standard 

1  Calls  1 

Function 

Where  Described 

clip  to  rect 

this  file 

dist2 

Measures.c 
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Table  2.10.2.6-2:  Function  Summary  -  clip_to_rect(edge_code,  start_pt, 
end_pt,  x_min,  x_max,  y_min,  y_max,  x_lnter,  y_inter) 

This  function  determines  if  a  point  is  outside  a  clipping  edge,  where  the  clipping  edge  is 
one  of  the  boundary  edges  of  a  rectangular  2-D  window.  &  so,  it  computes  the 
intersection. 
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2.10.3  CrossSection  CSC  Description 

This  CSC  supports  toggling  to  display  or  remove  a  plot  of  the  elevation  between  two  points 
in  the  terrain. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.10.3-1. 


Figure  2.10.3-1:  Tools— Cross-Section  CSC  Structure. 

2.10.3.1  cross. c 

This  eSU  plots  a  cross-section  through  the  terrain  in  a  pop-up  window. 
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Table  2.10.3.1*1:  Function  Summary  -  cross_section(x,  y,  x_,  y_) 

This  function  plots  a  cross  secticm  through  the  terrain.  The  cross  section  is  normalized  in 
elevation  and  teh  vertical  scale  exaggeration  is  integral. 
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Table  2.10.3.1-2:  Function  Summary  -  colin_cross 
(xO,  yO,  zO,  xl,  yl,  zl) 


Parameter 


xO.  vO.  zO.  x1.v1.z1 


Parameters 


Where  Tvpedef  Declared 


standard 


Function 


cross  menu  entry  on 


delete  window 


create  window 


cross  menu  entry  off 


rrsi 


compute  elevation  seas 


In 


IV 


et  window  num 


draw  window 


rvcoor 


moihue 


ris 


isvncrb 


mqidash 


Calls 


Where  Described 


Edit  menu.c 


Pod  windows.c 


Poo  windows.c 


Edit  menu.c 


Concurrent  oraphics  library 


this  file 


Concurrent  oraphics  Ubrary 


Concurrent  oraphics  library 


Pop  windows.c 


Poo  windows.c 


Concurrent  oraphics  library 


Concurrent  oraphics  library 


Concurrent  oraphics  library 


Concurrent  oraphics  library 


Concurrent  oraphics  library 


Concurrent  oraphics  library 


subroutine 


subroutine 


subroutine 


subroutine 


subroutine 


subroutine 


subroutine 


subroutine 


subroutine 


Table  2.10.3.1-3:  Function  Summary  -  kill_cross_window() 
This  function  deletes  a  cross  section  window. 


1  Calls  1 

Function 

Where  Described 

cross  menu  entry  on 

edit  menu.c 

delete  window 

Poo  windows.c 
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Table  2.10.3.1-4:  Function  Summary  -  compute_elevation_segs 
(from_x,  from_y,  to_x,  to_y,  numjines,  x  array, 
z_array,  min_eTevation,  max^lcvation) 

This  function  returns  an  array  of  elevation  points  along  a  given  segment. 
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2.11  REMOTE  DEVICES  INTERFACES 


This  CSC  sets  up  the  communications  data  structures  for  interfacing  with  the  Data  Lxtgger 
and  Stealth  over  the  SIMNET  network.  For  the  Data  Logger  it  also  sends  and  receives 
messages.  This  CSC  uses  logger  protocol  to  communicate  with  the  Data  Logger  and 
Stealth  protocol  to  initialize  and  process  Stealth  packets.  This  CSC  accesses  basic 
SIMNET  network  services  to  mt^ate  communication  with  the  Stealth  and  the  Logger. 

Event  Waypoints 

The  PVD  provides  a  set  of  menu  options,  'event  waypoints,'  for  annotating  an  exercise 
playback.  During  an  exercise,  an  analyst  may  want  to  annotate  the  recording  of  the 
exercise  with  event  type  information  not  described  by  any  of  the  available  SIMNET 
message  formats.  Selection  of  an  event  waypoint  causes  a  text  string  message,  called  an 
event  flag  Protocol  Data  Unit  (PDU),  to  be  recorded  in  sequence  with  the  other  PDUs 
being  sent  during  the  exercise.  A  technician  may  reprogram  event  waypoints  to  send  other 
text  strings  by  editing  the  file,  events.def.  Event  flag  PDUs  are  defin^  by  the  SIMNET 
data  collection  protocol  as  described  in"SIMNET  Network  and  Protocols,"  BBN  Report 
No.  1702. 


This  CSC  is  designed  to  hide  the  details  of  remote  device  communications  from  other  CSC 
functions. 


Logger 


The  PVD  controls  communications  with  the  Data  Logger  and  its  exercise  playback 
operations. 


Stealth 


The  PVD  controls  communications  with  the  Stealth  and  its  operations.  Initially,  the 
technician  must  reconfigure  the  PVD  system  to  make  the  Stealth  menu  options — which 
include  Teleport  and  Attach — available. 
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This  CSC  functionality  is  broken  down  into  lower-level  CSCs  shown  in  Figure  2-11. 


Figure  2-11:  Remote  Devices  Interfaces  CSC  Structure. 


2.11.1  Stealth  Interface  CSC  Description 


This  CSC  initializes,  dispatches,  processes,  and  stores  Stealth  messages.  This  CSC  also 
makes  use  of  the  functions  in  the  Network  Processing  CSC  (Section  2.6). 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.1 1.1-1. 


Stealth 

Interface 

3.11.1 


place.c 

3.11.1.1 

p_stlth.h 

3.11.1.2 


Figure  2.11.1-1:  Remote  Devices  Interfaces-Stealth  Interface 

CSC  Structure. 
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2.11.1.1  place. c 

This  CSU  provides  control  of  the  stealth  vehicle. 

Table  2.11.1.1-1:  Function  Summary  -  send_event_flag 
(vehicle_id,  code,  flag_string) 

This  function  broadcasts  an  event_flag  packet 


Parameters 


Parameter 


vehicle  id 


code 


flaa  strin 


Function 


et  vehicle  exercise 


AssocSendDataqram 


rint  vehicle  id 


inter  to  char 


Where  Tvpedef  Declared 


basic.h 


standard 


standard 


Calls 


Where  Described 


ibassoc.a  in  MCC  CSCI 


vd  misc.c 


Table  2.11.1.1-2:  Function  Summary  -  teleport_stealth 
(new_x,  new_y,  new_z,  azimuth) 

This  function  sends  a  teleport  message  point  to  point  to  the  stealth  vehicle  specified  by  the 
ethemet  address  in  the  pvd_initdat  file. 
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Table  2.11.1.1-3:  Function  Summary  -  attach_stealth(vehicle_id) 

This  function  sends  a  packet  commanding  the  stealth  vehicle  to  become  attached  to  the 
specified  vehicle. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vehicle  id 

pointer  to  VehiclelD 

basic.h 

1  Calls  1 

Function 

Where  Described 

PointToPointSendPDU 

see  libassoc  in  Vehicle  Simulation  CSCI 

qet  stealth  address 

init  env.c 

print  vehicle  id 

pvd  misc.c 

Table  2.11.1.1-4:  Function  Summary  -  mimic_vehicle 
(vehicle_idy  channel) 

This  function  sends  a  mimic  packet  (point  to  point)  to  the  stealth  vehicle  specified  in  the 
pvd_init.dat  file.  The  mimic  packet  causes  the  ste^th  vehicle  to  become  co-located  with  the 
vehicle  with  the  passed  vehicle_id. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vehicle  id 

int 

standard 

channel 

int 

standard 

1  Calls  1 

1  Function 

1  Where  Described  1 

1  Qet  stealth  net  address  I  I 

1  net  write 

1  Ibnetif.a  in  MCC  CSCI  1 

Table  2.11.1.1-5:  Function  Summary  -  set_stealth_exercise(exercise_id) 

This  function  assigns  the  stealth  vehicle  to  a  particular  exercise.  Upon  receipt  of  the 
packet,  Stealth  should  only  show  vehicles  in  from  that  exercise. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

exercise  id 

int 

standard 

1  Calls  1 

Function 

Where  Described 

PointToPointSendPDU 

see  libassoc  in  Vehicle  Simulation  CSCI 

aet  stealth  address 

init  env.c 
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Table  2.11.1.1-6:  Function  Summary  -  handIe_stealth_error(error_packet) 

This  function  prints  error  messages  received  from  the  stealth  vehicle. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

error  packet 

pointer  to  StealthErrorVariant 

p  stith.h 

Table  2.11.1.1-7:  Function  Summary  -  handle_attached_packet 

(attached_packet) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

attached  packet 

pointer  to  Attached  Variant 

p  stith.h 

1  Calls  1 

Function 

Where  Described 

oet  vehicle  index 

print  vehicle  id 

pvd  misc.c 

delete  attachment  icon 

create  attachment  icon 

Table  2.11.1.1-8:  Function  Summary  -  getJocation(vehicle_id,  x,  y,  z) 
This  function  determines  the  current  x,  y,  and  z  for  a  given  vehicle  ID. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

vehicle  id 

int 

standard 

tm— — 

pointer  to  float 

standard 

Table  2,11.1.1-9:  Function  Summary  -  construct_sim_from_stealth 

(stealth^pdu) 

This  function  creates  a  vehicle  appearance  packet  in  the  simulation  protocol  corresponding 
to  the  passed  stealth  appearance  packet. 


1  Parameters  1 

Parameter 

Where  Typedef  Declared 

stealth  pdu 

pointer  to  StealthPDU 

p  stith.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

&sim  pdu 

int 

pointer  to  sim  pdu 
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2.11.1.2  p_stlth.h 

This  is  a  protocol  file  for  the  stealth  vehicle.  It  is  a  commonly-maintained  file  used  by  Plan 
View  Display  and  other  SIMNET  applications. 


2.11.2  Logger  Interface  and  Control  CSC  Description 


This  CSC  sets  up  and  verifies  a  separate  network  connection  with  the  Logger.  This  CSC 
also  initializes  and  dispatches  Logger  data  and  command  messages.  In  addition,  this  CSC 
processes  and  stores  playback  exercise  data.  This  CSC  also  makes  use  of  the  functions  in 
the  Network  Processing  CSC  (Section  2.6). 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.1 1.2-1. 


Logger 

Interface 

& 

Control 

3-11-2 

loggerjcomm.c 

3.11.2.1 

pjogger.h 

3.11.2.2 
liblogpvd.a 

3.11.2.3 

libptcomm.a 

3.11.2.4 


Figure  2.11.2-1:  Remote  Devices  Interfaces— Logger  Interface 

CSC  Structure. 


2.11.2.1  Iogger_comm.c 

This  CSU  provides  control  of  the  logger. 
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Table  2.11.1.2-1:  Function  Summary  -  init_connections() 


This  function  initializes  logger  functions. 


r. 

r 


Function 


vd  phantom  tank  init 


et  Dt  host 


chanae  phantom  status 


Calls 


Where  Described 


r 


chanae  dataprobe  status 


vd  loaaer  init 


et  vr  host 


chanae  loaaer  status 


dl  connected 


Tabic  2.11.1.2-2:  Function  Summary  -  get  loggerAvailReplys 
(buf,  length,  group,  protocol,  orginator) 


Parameter 


buf 


lenath 


rotocol 


oriainator 


Parameters 


e 


inter  to  LoaaerPDU 


int 


MutticastGroupID 


AssociationUserProtocol 


inter  to  SimulationAddress 


Where  Tvpedef  Declared 


standard 


assoc.h 


assoc.h 


address.h 


Return  Values 


Return  Value 


1 


0 


Function 


et  vr  host 


rint  simulation  address 


Meanin 


handles  the  packet 


left  to  someone  else 


Calls 


Where  Described 


Init  env.c 


vd  misc.c 


Table  2.11.1.2-3:  Function  Summary  -  TindJoggersO 
This  function  returns  1  if  any  loggers  were  found,  0  otherwise. 
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Function 


init  workina  cursor 


do  avail  request 


send  rtc 


set  text  window 


et  vr  host 


net  oettime 


rocess  nonappearance  packets 


init  cursor 


Calls 


Where  Described 


Pvd  iface.c 


Pvdrtc.c 


send  rtc.c 


T  windows.c 


Init  env.c 


ibnetif.a  in  MCC  CSCI 


Pvd  rface.c 


Table  2.11.1.2-4:  Function  Summary  -  get  loggerConnectAck 
(buf,  length,  group,  protocol,  originator) 

This  function  processes  replies  to  connection  requests.  It  returns  0  if  the  packet  is  not 
handled. 


Parameter 


buf 


lenqth 


rotocol 


oriqinator 


Return  Value 


1 


Parameters 


inter  to  LoqqerPDU 


int 


MutticastGrouolD 


AssociationUserProtocol 


inter  to  SimulationAddress 


Return  Values 


Where  Tvoedef  Declared 


standard 


assoc. h 


assoc.h 


address,  h 


acket  not  handled 


acket  handled 


Table  2.11.1.2-5:  Function  Summary  -  connect_to_logger() 

This  function  connects  to  the  requested  logger. 


Calls 

Function 

Where  Described 

init  workina  cursor 

Pvd  iface.c 

init  Ddu 

Pvdrtc.c 

send  rtc 

Pvdrtc.c 

net  qettime 

ibnetif.a  in  MCC  CSCI 

rocess  nonappearance  packets 


chance  locoer  status 


init  cursor 


Pvd  iface.c 
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Table  2.11.1.2*6:  Function  Summary  -  discon nect_d I () 
This  function  disconnects  from  the  current  datalogger. 


Cal 

Is 

Function 

Where  Described 

do  disconnect 

Pvdrtc.c 

send  rtc 

Pvdrtc.c 

net  zeroaddr 

ibnetif.a  in  MCC  CSCI 

chanae  logger  status 

Table  2.11.1.2-7:  Function  Summary  -  pIay_Iogger() 
This  function  provides  initialization  data  to  the  logger  for  playback. 


1  Calls  1 

Function 

Where  Described 

get  typed  input  str 

Interact.c 

do  start  playback  command 

Pvdrtc.c 

send  rtc 

Pvdrtc.c 

Table  2.11.1.2-8:  Function  Summary  -  record_Iogger() 
This  function  moves  the  logger  into  the  recording  state. 


Ca 

Is 

Function 

Where  Described 

get  exercise 

get  current  time 

do  start  record  command 

Pvdrtc.c 

send  rtc 

Pvdrtc.c 

Table  2.11.1.2-9:  Function  Summary  -  continue_logger() 
This  function  sends  a  "Continue"  command  to  the  logger. 


Calls 

Function 

Where  Described 

do  continue  command 

Pvdrtc.c 

send  rtc 

Pvdrtc.c 
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Table  2.11.1.2-10:  Function  Summary  -  Iogger_freeze() 
This  function  sends  the  "Suspend"  command  to  the  logger. 


1  calls  1 

Function 

Where  Described 

do  suspend  command 

Pvdrtc.c 

send  rtc 

Pvdrtc.c 

Table  2.11.1.2-11:  Function  Summary  -  logger_stop() 


This  function  sends  the  "Stop"  command  to  the  logger. 


Cal 

Is 

Function 

Where  Described 

do  stop  command 

Pvdrtc.c 

send  rtc 

Pvdrtc.c 

Table  2.11.1.2-12:  Function  Summary  -  logger_speed(speed) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

speed 

int 

standard 

1  Calls  1 

Function 

Where  Described 

do  play  speed  command 

Pvdrtc.c 

send  rtc 

Pvdrtc.c 

Table  2.11.1.2-13:  Function  Summary  -  logger_seek(seconds, 

relative  to  current  loc) 


Parameters 


Parameter 


seconds 


relative  to  current  loc 


Where  Typedef  Declared 


standard 


standard 


1  Calls 

Function 

Where  Described 

do  seek  relative  command 

Pvdrtc.c 

send  rtc 

Pvdrtc.c 
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Table  2.11.1.2-14:  Function  Summary  -  geMogger_address() 
This  function  returns  the  logger's  address. 


1  Return  Values  1 

Return  Value 

Meaning 

&Logger_S_Address 

SimulationAddress 

pointer  to  logger  simulation 
address 

Table  2.11.1.2-15:  Function  Summary  -  get_Iogger_name() 
This  function  returns  the  logger's  name. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

Logger  Name 

pointer  to  char 

logger  name 

Table  2.11.1.2-16:  Function  Summary  -  get_logger_name_from_address 

(addr) 

Given  a  simulation  address,  this  function  returns  the  name  of  the  corresponding  logger  (or 
the  string  "Unknown"). 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

addr 

pointer  to  SimulationAddress 

address.h 

1  Return  Values  I 

Return  Value 

Meaning 

Logger  Namesllogger  index! 

pointer  to  char 

returns  name  of  logger 

"Unknown" 

char 

returns  string  “Unknown” 

Table  2.11.1.2-17:  Function  Summary  -  get_logger_broadcast_address() 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

&LoggerBroadcastAddr 

pointer  to  SimulationAddress 

pointer  to  logger  broadcast 
address 

2.11.2.2  p_logger.h 

This  is  a  protocol  file  for  the  logger.  It  is  a  commonly-maintained  file  used  by  Plan  View 
Display  and  other  SIMNET  applications. 
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2.11.2.3  liblogpvd.a  CSU  Description  (/simnet/pvd/libsrc) 


This  library  supports  the  logger  interface  and  is  used  only  by  the  PVD.  These  are  pvd- 
specific  sources  for  liblogpvd.aTable  cmc.c;  cmc.h;  filter.c;  filter.h;  global.h,  logger.c; 
logger.h;  logger.old.c;  logpvd.c;  logpvd.h;  Ititne.c;  Itime.h;  projogger.h;  pvd.c;  (Section 
2.4.1. 1);  pvdrtc.c  (Section  3.11.3.1);  pvdrtc.h;  queue.c;  queue.h;  racal.c;  racal.h;  rtc.c; 
rth.c;  rtc.h;  user.c;  user.h;  user.old.c;  util.c;  util.h. 


2.11.2.4  libptcomm.a  CSU  Description  (/simnet/pvd/libsrc/libcomm) 

The  only  function  from  libptcomm.a  that  is  called  from  this  library  is  pvd_logger_exit(), 
from  pvd21ogger.c. 

Table  2.11.2.4-1:  libptcomm.a  Information. 


1  External  Static  Variables  I 

Variable 

Where  Typedef  Declared 

logger_skt: 

int 

bufferlBUFFER  LENGTH] 

char 

Table  2.11.2.4-2;  pvd_logger_exit()  Information. 

This  function  does  two  kinds  of  closes  on  a  socket  that  is  not  open. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

int 

Calls 

Function 

1  Where  Described 

close  network 

I 
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2.11.3  Initial  Remote  Interfaces  CSC  Description 

This  CSC  is  the  main  entry  for  Remote  Devices  Interfaces. 

This  CSC  functionality  is  broken  down  into  the  CSUs  shown  in  Figure  2.1 1.3-1. 


Initial 

3.11.3 


pvdrtc.c 

3.11.3.1 


Figure  2.11.3<1:  Remote  Devices  Interfaces-Initial  Remote  Interfaces 

CSC  Structure. 

2.11.3.1  pvdrtc.c 

This  CSU  handles  real-time  commands  to  and  from  the  Data  Logger. 


Table  2.11.3.1-1:  Function  Summary  -  handle_log_rtc(rtc) 
This  function  handles  processing  of  runtime  messages  from  the  Logger. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

rtc 

pointer  to  LoqqerPDU 

D  loqqer.h 

Table  2.11.3.1-2: 

Function  Summary  -  send_rtc(rtc,  length) 

This  function  places  the  rtc  on  the  CMC  network. 

1  Parameters  1 

Parameter 

Where  Typedef  Declared 

rtc 

pointer  to  LoqqerPDU 

p  loqqer.h 

lenqth 

int 

standard 
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Function 


AssocSendDataqram 


Calls 


Where  Descri  bed 


ibassoc.a  in  MCC  CSCI 


Table  2.11.3.1-3:  Function  Summary  -  init_pdu(packet,  kind,  destination) 


n 


Parameter 


acket 


kind 


destination 


Parameters 


e  Where  Typedef  Declared 


inter  to  LoaoerPDU 


int  standard 


inter  to  SimulationAddress  I  address. h 


iezt;: 


irs 


Table  2.11.3.1-4:  Function  Summary  -  avail_reply_handler(inrtc) 


Parameters 


Parameter 


inrtc 


Where  Typedef  Declared 


Table  2.11.3.1-5:  Function  Summary  -  connect_ack_nak_handler(buf) 


Parameter 


but 


Parameters 


inter  to  LoqqerPDU 


Where  Typedef  Declared 


Function 


et  loqaer  address 


et  loqqer  name 


rint  simulation  address 


Calls 


Where  Described 


Loaoer  comm.c 


Loqqer  comm.c 


vd  misc.c 


Table  2.11.3.1-6:  Function  Summary  -  information_handler(inrtc) 


Parameter 


inrtc 


Parameters 


inter  to  LoooerPDU 


Where  Typedef  Declared 


Function 


et  loqqer  name 


Calls 


Where  Described 


Loqqer  comm.c 


384 


BBN  Systems  and  Technologies 


Plan  View  Display  CSCI 


Table  2.11.3.1-7:  Function  Summary  -  cIock_tick_handler(inrtc) 


Parameters 


Parameter 


inrtc 


Function 


offset  datetime 


datetime  to  strings 


Where  Tvnedef  Declared 


inter  to  LoggerPDU 


Calls 


Where  Described 


Table  2.11.3.1-8:  Function  Summary  -  status_reply_handler(inrtc) 


Parameters 


Parameter 


inrtc 


Function 


et  loaoer  name  from  address 


inter  to  LoaaerPDU 


Where  Typedef  Declared 


Calls 


Where  Described 


Loaoer  comm.c 


Table  2.11.3.1-9:  Function  Summary  -  do_avail_request(pdu) 


Parameters 


Parameter 


du 


Function 


init  Ddu 


et  loaoer  broadcast  address 


Where  Typedef  Declared 


inter  to  LoggerPDU 


Calls 


Where  Described 


Pvdrtc.c 


Logger  comm.c 


Table  2.11.3.1-10: 


Parameter 


du 


destination 


Function  Summary  -  do_connect_request(pdu, 
destination)" 


Parameters 


e  Where  Typedef  Declared 


inter  to  LoggerPDU 


inter  to  SimuiationAddress  I  address.h 


1  Calls 

Function 

Where  Described 

init  Ddu 

Pvdrtc.c 
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Table  2.11.3.1-11:  Function  Summary  -  do_disconnect(pdu,  destination) 


Parameter 


du 


destination 


Parameters 


e  I  Where  Tvoedef  Declared 


inter  to  LooaerPDU 


inter  to  SimuiationAddress  address.h 


Function 


mit  Ddu 


Calls 


Where  Described 


Pvdrtc.c 


Table  2.11.3.1-12:  Function  Summary  -  do_start_recording_command 
(pdu,  destination,  starttime,  is_contig,  is_Tooping,  is_promiscuous, 
racal_present,  medium,  nvolumes,  nexercises,  sizes,  exercise_ids, 

file_nms,  projid,  comment) 


Parameter 


du 


destination 


starttime 


IS  looDin 


is  promiscuous 


racal  present 


mediume 


nvolumes 


nexercises 


sizes 


exercise  ids 


file  names 


rojid 


comment 


Parameters 


e 


inter  to  LooaerPDU 


inter  to  SimuiationAddress 


inter  to  LoooerTime 


BOOL 


BOOL 


BOOL 


BOOL 


int 


int 


int 


array  of  int 


array  of  int 


array  of  pointer  to  char 


inter  to  char 


inter  to  char 


Where  Tvpedef  Declared 


sim  types. h 


Sim  types. h 


sim  types. h 


Sim  types. h 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


standard 


Calls 

Function 

Where  Described 

init  Pdu 

Pvdrtc.c 
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Table  2.11.3.1-13:  Function  Summary  -  do_start_playback_command 
(pdu,  destination,  is  looping,  racal_present,  medium, 
nvolumes,  size,  exercTseid,  file_nms,  filter_out_steaIth) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pdu 

pointer  to  LooQerPOU 

p  loaaer.h 

destination 

pointer  to  SimulationAddress 

address. h 

is  looping 

BOOL 

Sim  types. h 

racal  present 

BOOL 

Sim  tvpes.h 

medium 

int 

standard 

nvolumes 

int 

standard 

size 

int 

standard 

exerciseid 

int 

standard 

file  nms 

array  of  pointer  to  char 

standard 

filter  out  stealth 

int 

standard 

1  Calls  1 

Function 

1  Where  Described  1 

init  Pdu 

1  Pvdrtc.c 

1 

Table  2.11.3.1-14: 

Function  Summary  -  do 

continue  command 

(pdu,  destination) 

1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pdu 

pointer  to  LogqerPDU 

p  logqer.h 

destination 

pointer  to  SimulationAddress 

address.h 

1  Calls  1 

Function 

Where  Described 

init  pdu 

Pvdrtc.c 

Table  2.11.3.1-15:  Function  Summary  -  do_suspend_command 

(pdu,  destination) 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

pdu 

pointer  to  LoggerPDU 

p  logger. h 

destination 

pointer  to  SimulationAddress 

address.h 

1  Calls  1 

Function 

Where  Described 

init  Pdu 

Pvdrtc.c 
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Table  2.11.3.1-16: 


Parameter 


du 


destination 


Function  Summary  -  do_stop_command 
(pdu,  destination) 


Parameters 


e  I  Where  Tvpedef  Declared 


inter  to  LoaoerPDU 


inter  to  SimulationAddress  address,  h 


Function 


init  Ddu 


Calls 


Where  Described 


Pvdrtc.c 


Table  2.11.3.1-17:  Function  Summary  -  do_seek_reIative_command 
(pdu,  dnation,  seconds,  reljcurloc) 


Parameter 


du 


destination 


seconds 


rel  curloc 


Parameters 


Where  Typedet  Declared 


inter  to  LoaoerPDU 


inter  to  SimulationAddress  address. h 


int  standard 


BOOL  Sim  types. h 


Function 


init  pdu 


Calls 


Where  Described 


Pvdrtc.c 


Table  2.11.3.1-18:  Function  Summary  -  do_play_speed_command 

(pdu,  destination,  factorl 


Parameter 


du 


destination 


(actor 


Parameters 


e  Where  Typedet  Declared 


inter  to  LoqqerPDU 


inter  to  SimulationAddress  address. h 


int  I  standard 


Function 


init  Ddu 


Calls 


Where  Described 


Pvdrtc.c 


Table  2.11.3.1-19:  Function  Summary  -  do_status_request(pdu) 


Parameters 


Parameter 


du 


irs 


Where  Typedet  Declared 


inter  to  LoqqerPDU 


Function 

Where  Described 

init  Ddu 

Pvdrtc.c 
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